Mailchimp

interface MailchimpConfig {
  apiKey:      string;   // Mailchimp API key (format: key-dc, e.g. abc123-us21)
  serverPrefix: string;  // Data center prefix extracted from API key (e.g. "us21")
  listId?:     string;   // Default audience list ID — can be overridden per campaign
}

import mailchimp from '@mailchimp/mailchimp_marketing';
 
class MailchimpTool {
  constructor(private cfg: MailchimpConfig) {
    mailchimp.setConfig({
      apiKey: cfg.apiKey,
      server: cfg.serverPrefix,
    });
  }
 
  async createDraftCampaign(options: {
    listId:      string;     // Mailchimp audience list ID
    subject:     string;
    previewText: string;
    fromName:    string;
    replyTo:     string;
    htmlContent: string;     // Full email HTML body
  }): Promise<{ campaignId: string; webId: number; editUrl: string }> {
    // Step 1: Create the campaign shell
    const campaign = await mailchimp.campaigns.create({
      type: 'regular',
      recipients: {
        list_id: options.listId,
      },
      settings: {
        subject_line:  options.subject,
        preview_text:  options.previewText,
        from_name:     options.fromName,
        reply_to:      options.replyTo,
        title:         `LM Draft - ${options.subject} - ${new Date().toISOString().slice(0, 10)}`,
      },
    });
 
    // Step 2: Set the content
    await mailchimp.campaigns.setContent(campaign.id, {
      html: options.htmlContent,
    });
 
    return {
      campaignId: campaign.id,
      webId:      campaign.web_id,
      editUrl:    `https://us${campaign.web_id}.admin.mailchimp.com/campaigns/edit?id=${campaign.web_id}`,
    };
  }
 
  async getAudiences(): Promise<{ id: string; name: string; memberCount: number }[]> {
    const response = await mailchimp.lists.getAllLists({ count: 50 });
    return response.lists.map((list: any) => ({
      id:          list.id,
      name:        list.name,
      memberCount: list.stats.member_count,
    }));
  }
 
  async verify(): Promise<void> {
    const ping = await mailchimp.ping.get();
    if (ping.health_status !== 'Everything\'s Chimpy!') {
      throw new Error('Mailchimp ping failed');
    }
  }
}

Email Writer agent generates HTML newsletter body
        │
        ▼ (HITL approval)
Email Publisher worker
  ├── Fetch generated HTML from MongoDB
  ├── Resolve tenant's Mailchimp integration
  ├── Get default audience list ID from integration metadata
  ├── Create draft campaign in Mailchimp
  └── Store campaignId + editUrl in email_campaigns table
        │
        ▼
DM Portal shows "View in Mailchimp" link for final send

Always use Mailchimp merge tags for personalization:
- *|FNAME|* for first name
- *|EMAIL|* for email address
- *|CURRENT_YEAR|* for current year