Mailchimp Connection

Connects your agent to Mailchimp Marketing for newsletters, drip sequences, and broadcast email. Read audiences and campaign reports, draft sends, and trigger transactional flows.

Authentication

API key. Generate at Mailchimp → Account → API keys. Keys are suffixed with the data center (e.g. …-us12); split that suffix into MAILCHIMP_DC.

• MAILCHIMP_API_KEY — full key (used as Basic auth password with username anystring, or as Bearer)
• MAILCHIMP_DC — data center segment of the key (drives the base URL)

Endpoints

Audiences (Lists)

• GET /lists — List all audiences
• GET /lists/{list_id} — Audience detail (member count, open rate, etc.)
• GET /lists/{list_id}/members — Subscribers
• GET /lists/{list_id}/segments — Saved segments

Campaigns

• GET /campaigns — Sent and draft campaigns
• GET /campaigns/{campaign_id} — Campaign detail
• GET /reports/{campaign_id} — Open/click/bounce report
• POST /campaigns — Draft a new campaign (requires confirmation)

Automations

• GET /automations — List automation workflows
• GET /automations/{workflow_id}/emails — Steps in a workflow

Rules

• Rate limit: 10 simultaneous connections per API key
• All write operations (create campaign, edit audience) require confirmation
• Member emails are PII — never echo full lists in logs