@divyacon/piece-mailchimp 0.0.0-stage → 0.1.0

package/dist/lib/triggers/unsubscribe-trigger.d.ts

@@ -0,0 +1,11 @@
+import { TriggerStrategy } from '@agnocon/pieces-framework';
+export declare const mailChimpUnsubscriberTrigger: import("@agnocon/pieces-framework").ITrigger<TriggerStrategy.WEBHOOK, import("@agnocon/pieces-framework").OAuth2Property<import("@agnocon/pieces-framework").OAuth2Props>, {
+    list_id: import("@agnocon/pieces-framework").DropdownProperty<string, true, import("@agnocon/pieces-framework").OAuth2Property<import("@agnocon/pieces-framework").OAuth2Props>>;
+}> | import("@agnocon/pieces-framework").ITrigger<TriggerStrategy.POLLING, import("@agnocon/pieces-framework").OAuth2Property<import("@agnocon/pieces-framework").OAuth2Props>, {
+    list_id: import("@agnocon/pieces-framework").DropdownProperty<string, true, import("@agnocon/pieces-framework").OAuth2Property<import("@agnocon/pieces-framework").OAuth2Props>>;
+}> | import("@agnocon/pieces-framework").ITrigger<TriggerStrategy.MANUAL, import("@agnocon/pieces-framework").OAuth2Property<import("@agnocon/pieces-framework").OAuth2Props>, {
+    list_id: import("@agnocon/pieces-framework").DropdownProperty<string, true, import("@agnocon/pieces-framework").OAuth2Property<import("@agnocon/pieces-framework").OAuth2Props>>;
+}> | import("@agnocon/pieces-framework").ITrigger<TriggerStrategy.APP_WEBHOOK, import("@agnocon/pieces-framework").OAuth2Property<import("@agnocon/pieces-framework").OAuth2Props>, {
+    list_id: import("@agnocon/pieces-framework").DropdownProperty<string, true, import("@agnocon/pieces-framework").OAuth2Property<import("@agnocon/pieces-framework").OAuth2Props>>;
+}>;
+//# sourceMappingURL=unsubscribe-trigger.d.ts.map

package/dist/lib/triggers/unsubscribe-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsubscribe-trigger.d.ts","sourceRoot":"","sources":["../../../src/lib/triggers/unsubscribe-trigger.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,eAAe,EAAY,MAAM,2BAA2B,CAAC;AAgFrF,eAAO,MAAM,4BAA4B;;;;;;;;EAmIvC,CAAC"}

package/dist/lib/triggers/unsubscribe-trigger.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mailChimpUnsubscriberTrigger = void 0;
+const tslib_1 = require("tslib");
+// Vendored from Activepieces packages/pieces/community/mailchimp/src/lib/triggers/unsubscribe-trigger.ts (MIT).
+// Generated by packages/scripts/vendor-ap.mjs - do not edit by hand.
+const pieces_framework_1 = require("@agnocon/pieces-framework");
+const pieces_common_1 = require("@agnocon/pieces-common");
+const common_1 = require("../common");
+const __1 = require("../..");
+const WEBHOOK_DATA_STORE_KEY = 'mail_chimp_unsubscribe_webhook_data';
+const getUnsubscribeEventSummary = (request) => {
+    const data = request.data || {};
+    return {
+        email: data.email || 'N/A',
+        subscriber_id: data.id || 'N/A',
+        list_id: data.list_id || 'N/A',
+        email_type: data.email_type || 'html',
+        ip_address: data.ip_opt || data.ip_signup || 'N/A',
+        signup_timestamp: data.timestamp_signup || 'N/A',
+        opt_in_timestamp: data.timestamp_opt || 'N/A',
+        unsubscribe_timestamp: request.fired_at || 'N/A',
+        has_merge_fields: !!data.merges,
+        merge_field_count: data.merges ? Object.keys(data.merges).length : 0,
+        merge_fields_summary: data.merges ? {
+            first_name: data.merges.FNAME || 'N/A',
+            last_name: data.merges.LNAME || 'N/A',
+            company: data.merges.COMPANY || 'N/A',
+            phone: data.merges.PHONE || 'N/A',
+            interests: data.merges.INTERESTS || 'N/A',
+            has_address: !!data.merges.ADDRESS,
+        } : null,
+        member_rating: data.member_rating || 0,
+        vip_status: data.vip ? 'VIP' : 'Standard',
+        language: data.language || 'en',
+    };
+};
+const calculateSubscriberLifetime = (request) => {
+    const data = request.data || {};
+    const signupTime = data.timestamp_signup ? new Date(data.timestamp_signup) : null;
+    const unsubscribeTime = request.fired_at ? new Date(request.fired_at) : null;
+    if (signupTime && unsubscribeTime) {
+        const diffTime = Math.abs(unsubscribeTime.getTime() - signupTime.getTime());
+        const diffDays = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
+        return `${diffDays} days`;
+    }
+    return 'Unknown';
+};
+const assessEngagementLevel = (request) => {
+    const data = request.data || {};
+    const rating = data.member_rating || 0;
+    if (rating >= 4)
+        return 'High';
+    if (rating >= 2)
+        return 'Medium';
+    return 'Low';
+};
+const identifyChurnFactors = (request) => {
+    const factors = [];
+    const data = request.data || {};
+    if (data.member_rating && data.member_rating < 3) {
+        factors.push('Low engagement rating');
+    }
+    if (request.unsubscribe_reason) {
+        factors.push(`Reason: ${request.unsubscribe_reason}`);
+    }
+    if (request.campaign_id) {
+        factors.push('Campaign-specific unsubscribe');
+    }
+    return factors.length > 0 ? factors : ['No specific factors identified'];
+};
+exports.mailChimpUnsubscriberTrigger = (0, pieces_framework_1.createTrigger)({
+    auth: __1.mailchimpAuth,
+    name: 'unsubscribe',
+    displayName: 'Member Unsubscribed from Audience',
+    description: 'Fires when a subscriber unsubscribes from your Mailchimp audience. This trigger captures unsubscribe events, opt-outs, and audience churn with comprehensive subscriber information for retention analysis.',
+    aiMetadata: {
+        description: 'Fires when a contact unsubscribes (opts out) from the selected Mailchimp audience (list). The event carries the subscriber email, merge fields, and, when available, the unsubscribe reason and originating campaign.',
+    },
+    type: pieces_framework_1.TriggerStrategy.WEBHOOK,
+    props: {
+        list_id: common_1.mailchimpCommon.mailChimpListIdDropdown,
+    },
+    sampleData: {
+        type: 'unsubscribe',
+        fired_at: '2024-01-15T10:30:00Z',
+        data: {
+            id: '8a25ff1d98',
+            list_id: 'a6b5da1054',
+            email: 'api@mailchimp.com',
+            email_type: 'html',
+            ip_opt: '192.168.1.100',
+            ip_signup: '192.168.1.100',
+            timestamp_signup: '2024-01-01T09:00:00Z',
+            timestamp_opt: '2024-01-01T09:00:00Z',
+            merges: {
+                EMAIL: 'api@mailchimp.com',
+                FNAME: 'Mailchimp',
+                LNAME: 'API',
+                COMPANY: 'Mailchimp Inc',
+                PHONE: '+1-555-0123',
+                INTERESTS: 'Group1,Group2',
+                ADDRESS: {
+                    addr1: '675 Ponce de Leon Ave NE',
+                    addr2: 'Suite 5000',
+                    city: 'Atlanta',
+                    state: 'GA',
+                    zip: '30308',
+                    country: 'US',
+                },
+            },
+            member_rating: 3,
+            vip: false,
+            language: 'en',
+            source: 'api',
+            tags: ['api-signup', 'churned-subscriber'],
+            unsubscribe_reason: 'too_many_emails',
+            campaign_id: 'campaign_123',
+            campaign_title: 'Weekly Newsletter',
+        },
+    },
+    onEnable(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a;
+            try {
+                const accessToken = (0, pieces_common_1.getAccessTokenOrThrow)(context.auth);
+                const server = yield common_1.mailchimpCommon.getMailChimpServerPrefix(accessToken);
+                const enabledWebhookId = yield common_1.mailchimpCommon.enableWebhookRequest({
+                    server,
+                    listId: context.propsValue.list_id,
+                    token: accessToken,
+                    webhookUrl: context.webhookUrl,
+                    events: {
+                        unsubscribe: true,
+                        profile: true,
+                    },
+                });
+                yield ((_a = context.store) === null || _a === void 0 ? void 0 : _a.put(WEBHOOK_DATA_STORE_KEY, {
+                    id: enabledWebhookId,
+                    listId: context.propsValue.list_id,
+                }));
+            }
+            catch (error) {
+                throw new Error(`Failed to enable unsubscribe webhook: ${error.message || JSON.stringify(error)}`);
+            }
+        });
+    },
+    onDisable(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a;
+            try {
+                const webhookData = yield ((_a = context.store) === null || _a === void 0 ? void 0 : _a.get(WEBHOOK_DATA_STORE_KEY));
+                if (webhookData === undefined || webhookData === null) {
+                    return;
+                }
+                const token = (0, pieces_common_1.getAccessTokenOrThrow)(context.auth);
+                const server = yield common_1.mailchimpCommon.getMailChimpServerPrefix(token);
+                yield common_1.mailchimpCommon.disableWebhookRequest({
+                    server,
+                    token,
+                    listId: webhookData.listId,
+                    webhookId: webhookData.id,
+                });
+            }
+            catch (error) {
+                console.error(`Failed to disable unsubscribe webhook: ${error.message || JSON.stringify(error)}`);
+            }
+        });
+    },
+    run(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const request = context.payload.body;
+                if (request === undefined || request.type !== 'unsubscribe') {
+                    return [];
+                }
+                const enhancedRequest = Object.assign(Object.assign({}, request), { trigger_type: 'member_unsubscribed', event_category: 'Unsubscribe Event', processed_at: new Date().toISOString(), unsubscribe_summary: getUnsubscribeEventSummary(request), business_context: {
+                        audience_churn: true,
+                        retention_concern: true,
+                        feedback_opportunity: true,
+                        re_engagement_potential: 'medium',
+                    }, retention_insights: {
+                        subscriber_lifetime: calculateSubscriberLifetime(request),
+                        engagement_level: assessEngagementLevel(request),
+                        churn_risk_factors: identifyChurnFactors(request),
+                    } });
+                return [enhancedRequest];
+            }
+            catch (error) {
+                console.error(`Error processing unsubscribe webhook: ${error.message || JSON.stringify(error)}`);
+                return [];
+            }
+        });
+    },
+});
+//# sourceMappingURL=unsubscribe-trigger.js.map

package/dist/lib/triggers/unsubscribe-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsubscribe-trigger.js","sourceRoot":"","sources":["../../../src/lib/triggers/unsubscribe-trigger.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@divyacon/piece-mailchimp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "DivyaCon mailchimp connector",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE.MIT-AP"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "vendor": "node ../scripts/vendor-ap.mjs piece-mailchimp"
+  },
+  "dependencies": {
+    "@agnocon/core-utils": "0.2.0",
+    "@agnocon/piece-types": "0.3.1",
+    "@agnocon/pieces-common": "0.12.8",
+    "@agnocon/pieces-framework": "0.36.0",
+    "tslib": "2.6.2",
+    "@mailchimp/mailchimp_marketing": "3.0.80"
+  },
+  "devDependencies": {
+    "@types/node": "20.17.6",
+    "typescript": "5.5.4",
+    "@types/mailchimp__mailchimp_marketing": "3.0.22"
+  },
+  "license": "MIT",
+  "agnocon": {
+    "originVersion": "0.5.7"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "keywords": [
+    "agnocon",
+    "connector"
+  ]
 }

package/src/index.ts

@@ -0,0 +1,77 @@
+import { PieceAuth, createPiece } from '@agnocon/pieces-framework';
+import { addMemberToList } from './lib/actions/add-member-to-list';
+import { addNoteToSubscriber } from './lib/actions/add-note-to-subscriber';
+import { removeSubscriberFromTag } from './lib/actions/remove-subscriber-from-tag';
+import { updateSubscriberInList } from './lib/actions/update-subscriber-status';
+import { addSubscriberToTag } from './lib/actions/add-subscriber-to-tag';
+import { createCampaign } from './lib/actions/create-campaign';
+import { getCampaignReport } from './lib/actions/get-campaign-report';
+import { createAudience } from './lib/actions/create-audience';
+import { archiveSubscriber } from './lib/actions/archive-subscriber';
+import { unsubscribeEmail } from './lib/actions/unsubscribe-email';
+import { findCampaign } from './lib/actions/find-campaign';
+import { findCustomer } from './lib/actions/find-customer';
+import { findTag } from './lib/actions/find-tag';
+import { findSubscriber } from './lib/actions/find-subscriber';
+import { createTag } from './lib/actions/create-tag';
+import { sendCampaign } from './lib/actions/send-campaign';
+import { createCustomEvent } from './lib/actions/create-custom-event';
+
+import { PieceCategory } from '@agnocon/pieces-framework';
+import { mailChimpSubscribeTrigger } from './lib/triggers/subscribe-trigger';
+import { mailChimpUnsubscriberTrigger } from './lib/triggers/unsubscribe-trigger';
+import { mailChimpNewCampaignTrigger } from './lib/triggers/new-campaign-trigger';
+import { mailChimpLinkClickedTrigger } from './lib/triggers/link-clicked-trigger';
+import { mailChimpEmailOpenedTrigger } from './lib/triggers/email-opened-trigger';
+import { mailChimpSubscriberUpdatedTrigger } from './lib/triggers/subscriber-updated-trigger';
+import { mailChimpNewCustomerTrigger } from './lib/triggers/new-customer-trigger';
+import { mailChimpNewOrderTrigger } from './lib/triggers/new-order-trigger';
+import { mailChimpNewSegmentTagSubscriberTrigger } from './lib/triggers/new-segment-tag-subscriber-trigger';
+
+export const mailchimpAuth = PieceAuth.OAuth2({
+  description: '',
+  authUrl: 'https://login.mailchimp.com/oauth2/authorize',
+  tokenUrl: 'https://login.mailchimp.com/oauth2/token',
+  required: true,
+  scope: [],
+});
+
+export const mailchimp = createPiece({
+  displayName: 'Mailchimp',
+  description: 'All-in-One integrated marketing platform for managing audiences, sending campaigns, tracking engagement, and automating lifecycle communications.',
+  minimumSupportedRelease: '0.30.0',
+  logoUrl: 'https://cdn.activepieces.com/pieces/mailchimp.png',
+  authors: ["abdullahranginwala","TaskMagicKyle","kishanprmr","AbdulTheActivePiecer","khaledmashaly","abuaboud", "sparkybug", "onyedikachi-david"],
+  categories: [PieceCategory.MARKETING],
+  auth: mailchimpAuth,
+  actions: [
+    addMemberToList,
+    addNoteToSubscriber,
+    addSubscriberToTag,
+    removeSubscriberFromTag,
+    updateSubscriberInList,
+    createCampaign,
+    getCampaignReport,
+    createAudience,
+    archiveSubscriber,
+    unsubscribeEmail,
+    findCampaign,
+    findCustomer,
+    findTag,
+    findSubscriber,
+    createTag,
+    sendCampaign,
+    createCustomEvent,
+  ],
+  triggers: [
+    mailChimpSubscribeTrigger, 
+    mailChimpUnsubscriberTrigger,
+    mailChimpNewCampaignTrigger,
+    mailChimpLinkClickedTrigger,
+    mailChimpEmailOpenedTrigger,
+    mailChimpSubscriberUpdatedTrigger,
+    mailChimpNewCustomerTrigger,
+    mailChimpNewOrderTrigger,
+    mailChimpNewSegmentTagSubscriberTrigger,
+  ],
+});

package/src/lib/actions/add-member-to-list.ts

@@ -0,0 +1,180 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { getAccessTokenOrThrow } from '@agnocon/pieces-common';
+import { mailchimpCommon } from '../common';
+import { mailchimpAuth } from '../..';
+import mailchimp from '@mailchimp/mailchimp_marketing';
+import { MailchimpClient } from '../common/types';
+import crypto from 'crypto';
+
+export const addMemberToList = createAction({
+  auth: mailchimpAuth,
+  name: 'add_member_to_list',
+  displayName: 'Add or Update Subscriber',
+  description: 'Add a new subscriber to an audience or update existing subscriber',
+  audience: 'both',
+  aiMetadata: { description: 'Upserts a member into a Mailchimp audience (list) keyed on the email address: creates the subscriber if absent (using the "status if new" value) or updates the existing record otherwise. Use to ensure a contact exists with given status, name, language, or VIP flag without checking first. Requires the target list and email; repeating with the same input is safe and converges to the same member state.', idempotent: true },
+  props: {
+    list_id: mailchimpCommon.mailChimpListIdDropdown,
+    email_address: Property.ShortText({
+      displayName: 'Email Address',
+      description: 'Email address for the subscriber',
+      required: true,
+    }),
+    status_if_new: Property.StaticDropdown({
+      displayName: 'Status if New',
+      description: 'Status for new subscribers',
+      required: true,
+      options: {
+        options: [
+          { label: 'Subscribed', value: 'subscribed' },
+          { label: 'Unsubscribed', value: 'unsubscribed' },
+          { label: 'Cleaned', value: 'cleaned' },
+          { label: 'Pending', value: 'pending' },
+          { label: 'Transactional', value: 'transactional' },
+        ],
+      },
+    }),
+    email_type: Property.StaticDropdown({
+      displayName: 'Email Type',
+      description: 'Type of email this member wants to receive',
+      required: false,
+      options: {
+        options: [
+          { label: 'HTML', value: 'html' },
+          { label: 'Text', value: 'text' },
+        ],
+      },
+    }),
+    status: Property.StaticDropdown({
+      displayName: 'Status',
+      description: 'Current status of subscriber (for updates)',
+      required: false,
+      options: {
+        options: [
+          { label: 'Subscribed', value: 'subscribed' },
+          { label: 'Unsubscribed', value: 'unsubscribed' },
+          { label: 'Cleaned', value: 'cleaned' },
+          { label: 'Pending', value: 'pending' },
+          { label: 'Transactional', value: 'transactional' },
+        ],
+      },
+    }),
+    first_name: Property.ShortText({
+      displayName: 'First Name',
+      description: 'First name of the subscriber',
+      required: false,
+    }),
+    last_name: Property.ShortText({
+      displayName: 'Last Name',
+      description: 'Last name of the subscriber',
+      required: false,
+    }),
+    language: Property.ShortText({
+      displayName: 'Language',
+      description: 'Subscriber language (e.g., "en", "es", "fr")',
+      required: false,
+    }),
+    vip: Property.Checkbox({
+      displayName: 'VIP',
+      description: 'VIP status for subscriber',
+      required: false,
+      defaultValue: false,
+    }),
+    skip_merge_validation: Property.Checkbox({
+      displayName: 'Skip Merge Validation',
+      description: 'Accept member data without merge field values even if required',
+      required: false,
+      defaultValue: false,
+    }),
+  },
+  async run(context) {
+    const accessToken = getAccessTokenOrThrow(context.auth);
+    const server = await mailchimpCommon.getMailChimpServerPrefix(accessToken);
+    
+    const client = mailchimp as unknown as MailchimpClient;
+    client.setConfig({
+      accessToken: accessToken,
+      server: server,
+    });
+
+    try {
+      const subscriberHash = crypto.createHash('md5').update(context.propsValue.email_address.toLowerCase()).digest('hex');
+      
+      const memberData: any = {
+        email_address: context.propsValue.email_address,
+        status_if_new: context.propsValue.status_if_new,
+      };
+
+      if (context.propsValue.email_type) {
+        memberData.email_type = context.propsValue.email_type;
+      }
+      
+      if (context.propsValue.status) {
+        memberData.status = context.propsValue.status;
+      }
+      
+      if (context.propsValue.first_name || context.propsValue.last_name) {
+        memberData.merge_fields = {};
+        if (context.propsValue.first_name) {
+          memberData.merge_fields.FNAME = context.propsValue.first_name;
+        }
+        if (context.propsValue.last_name) {
+          memberData.merge_fields.LNAME = context.propsValue.last_name;
+        }
+      }
+      
+      if (context.propsValue.language) {
+        memberData.language = context.propsValue.language;
+      }
+      
+      if (context.propsValue.vip !== undefined) {
+        memberData.vip = context.propsValue.vip;
+      }
+
+      const queryParams: any = {};
+      if (context.propsValue.skip_merge_validation) {
+        queryParams.skip_merge_validation = true;
+      }
+
+      const member = await client.lists.setListMember(
+        context.propsValue.list_id!,
+        subscriberHash,
+        memberData,
+        queryParams
+      );
+
+      return {
+        success: true,
+        id: member.id,
+        email_address: member.email_address,
+        unique_email_id: member.unique_email_id,
+        contact_id: member.contact_id,
+        full_name: member.full_name,
+        web_id: member.web_id,
+        email_type: member.email_type,
+        status: member.status,
+        merge_fields: member.merge_fields,
+        interests: member.interests,
+        stats: member.stats,
+        ip_signup: member.ip_signup,
+        timestamp_signup: member.timestamp_signup,
+        ip_opt: member.ip_opt,
+        timestamp_opt: member.timestamp_opt,
+        member_rating: member.member_rating,
+        last_changed: member.last_changed,
+        language: member.language,
+        vip: member.vip,
+        email_client: member.email_client,
+        location: member.location,
+        marketing_permissions: member.marketing_permissions,
+        source: member.source,
+        tags_count: member.tags_count,
+        tags: member.tags,
+        list_id: member.list_id,
+        _links: member._links,
+      };
+    } catch (error: any) {
+      throw new Error(`Failed to add or update subscriber: ${error.message || JSON.stringify(error)}`);
+    }
+  },
+});

package/src/lib/actions/add-note-to-subscriber.ts

@@ -0,0 +1,91 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { getAccessTokenOrThrow } from '@agnocon/pieces-common';
+import { mailchimpCommon } from '../common';
+import { mailchimpAuth } from '../..';
+
+export const addNoteToSubscriber = createAction({
+  auth: mailchimpAuth,
+  name: 'add_note_to_subscriber',
+  displayName: 'Add Note to Subscriber',
+  description: 'Add a note to a subscriber in your Mailchimp audience.',
+  audience: 'both',
+  aiMetadata: { description: 'Appends an internal note to a subscriber, identified by email within a given audience (list). Use to record context or annotations on a contact. Not idempotent: each call adds a new note even if the content is identical.', idempotent: false },
+  props: {
+    list_id: mailchimpCommon.mailChimpListIdDropdown,
+    email: Property.ShortText({
+      displayName: 'Email Address',
+      description: 'The email address of the subscriber to add a note to',
+      required: true,
+    }),
+    note: Property.LongText({
+      displayName: 'Note Content',
+      description: 'The note content to add to the subscriber',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const { list_id, email, note } = context.propsValue;
+    const accessToken = getAccessTokenOrThrow(context.auth);
+
+    try {
+      const serverPrefix = await mailchimpCommon.getMailChimpServerPrefix(accessToken);
+      const subscriberHash = mailchimpCommon.getMD5EmailHash(email);
+
+      const url = `https://${serverPrefix}.api.mailchimp.com/3.0/lists/${list_id}/members/${subscriberHash}/notes`;
+
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+          'Authorization': `Bearer ${accessToken}`,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          note: note,
+        }),
+      });
+
+      if (!response.ok) {
+        let errorMessage = `HTTP ${response.status}: ${response.statusText}`;
+        
+        try {
+          const errorText = await response.text();
+          if (errorText && errorText.trim()) {
+            const errorData = JSON.parse(errorText);
+            errorMessage = errorData.detail || errorData.title || errorData.message || errorText;
+          }
+        } catch (parseError) {
+          const errorText = await response.text();
+          if (errorText && errorText.trim()) {
+            errorMessage = errorText;
+          }
+        }
+
+        throw new Error(`Failed to add note to subscriber: ${errorMessage}`);
+      }
+
+      let result;
+      try {
+        const responseText = await response.text();
+        if (responseText && responseText.trim()) {
+          result = JSON.parse(responseText);
+        } else {
+          result = { success: true };
+        }
+      } catch (parseError) {
+        result = { success: true };
+      }
+
+      return {
+        success: true,
+        message: `Successfully added note to subscriber ${email}`,
+        note_id: result.id,
+        note_content: result.note,
+        created_at: result.created_at,
+        _links: result._links || [],
+      };
+    } catch (error: any) {
+      console.error('Error adding note to subscriber:', error);
+      throw new Error(`Failed to add note to subscriber: ${error.message}`);
+    }
+  },
+});