canonical: https://jentic.com/apis/mailchimp.com/mailchimp

# Mailchimp Marketing API

Send and track email campaigns, manage subscriber audiences, build automations, and analyze engagement across all marketing channels. Supports 274 endpoints covering campaigns, lists, automations, templates, landing pages, e-commerce integrations, and reporting with per-message open and click tracking. Audience segmentation uses behavioral and demographic conditions to target specific subscriber groups based on purchase history, engagement, and custom fields.

## For AI agents

Send email campaigns, manage subscriber lists, trigger automations, and retrieve audience engagement metrics. Covers 274 endpoints across campaigns, lists, templates, automations, and reporting.

## Scope

Does not handle transactional email delivery, SMS messaging, or CRM deal tracking - use for marketing email campaigns, audience management, and automation workflows only.

## Capabilities

- Send targeted email campaigns to segmented audiences based on behavioral and demographic conditions
- Build multi-step automation workflows triggered by subscriber events like sign-ups, purchases, or date milestones
- Track per-campaign open rates, click-through rates, bounce rates, and unsubscribe activity in real time
- Segment audiences using purchase history, email engagement, geographic location, and custom merge fields
- Sync e-commerce store data including products, orders, and carts for purchase-based automation triggers
- Design responsive email templates with drag-and-drop content blocks and conditional merge tag logic
- Schedule campaigns with send-time optimization based on subscriber timezone and historical engagement patterns

## Use cases

### AI Agent Email Campaign Orchestration

AI agents use the Mailchimp Marketing API through Jentic to programmatically create, schedule, and send email campaigns to targeted audience segments. The agent searches for 'send email campaign to segment' via Jentic, receives the matching operation schemas for /campaigns and /campaigns/{campaign_id}/actions/send, and executes the full workflow - from campaign creation to scheduling - without reading Mailchimp documentation. Integration takes under an hour compared to 2-3 days for direct API setup with OAuth and webhook configuration.

Example prompt: Create a new campaign targeting the 'Active Subscribers' segment with subject line 'Monthly Newsletter' and schedule it for next Tuesday at 10am EST

### Audience Segmentation and Targeting

Build dynamic audience segments based on subscriber behavior, purchase history, and engagement metrics. The Mailchimp Marketing API supports complex segmentation conditions combining email opens, link clicks, e-commerce purchases, geographic location, and custom merge fields. Segments update automatically as subscriber data changes, enabling real-time targeting for campaigns and automations across audiences with millions of contacts.

Example prompt: Create a segment of subscribers who opened at least 3 campaigns in the last 90 days and have made a purchase over $50

### Marketing Automation Workflows

Configure multi-step automation workflows triggered by subscriber events including sign-ups, purchases, date milestones, and custom API events. Each automation step can include delays, conditional branching based on engagement, and personalized content using merge tags. The API exposes full workflow management - create, start, pause, and monitor automations with per-email performance metrics for each step in the sequence.

Example prompt: Retrieve all automation workflows, identify those with less than 10% open rate on their first email, and pause them for review

### Campaign Performance Analytics

Retrieve detailed performance reports for email campaigns including open rates, click rates, bounce rates, unsubscribe counts, and revenue attribution from e-commerce tracking. Reports break down by subscriber activity, click maps showing which links received engagement, and time-series data showing when recipients opened and clicked. Data feeds into dashboards and triggers for automated follow-up campaigns targeting non-openers.

Example prompt: Get the open rate, click rate, and revenue generated for campaign ID 'abc123' and compare against the account average

### E-Commerce Integration and Purchase Tracking

Sync product catalogs, customer orders, and shopping cart data with Mailchimp for purchase-based automations and revenue reporting. The API supports creating stores, importing products with variants, recording orders with line items, and tracking abandoned carts. This enables automated post-purchase follow-ups, cart abandonment emails, and product recommendation campaigns based on actual purchase behavior.

Example prompt: Create a new e-commerce store connection, import 50 products with variants, and set up an abandoned cart automation trigger

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /campaigns | Create a new email campaign |
| POST | /campaigns/{campaign_id}/actions/send | Send a campaign |
| GET | /lists | List all audience lists |
| POST | /lists/{list_id}/members | Add a subscriber to an audience |
| GET | /reports/{campaign_id} | Get campaign performance report |
| GET | /automations | List all automation workflows |
| POST | /lists/{list_id}/segments | Create an audience segment |
| GET | /templates | List available email templates |

## Key resources

- **Campaigns** — Create, schedule, send, and report on email campaigns with audience targeting
- **Lists/Audiences** — Manage subscriber audiences, members, segments, and interest categories
- **Automations** — Configure and control multi-step email automation workflows
- **Templates** — Create and manage reusable email template designs
- **Reports** — Access campaign and automation performance analytics
- **E-Commerce** — Sync stores, products, orders, and carts for purchase-based marketing

## Why Jentic

- **Setup:** Wiring the Mailchimp Marketing API by hand means setting up its HTTP basic auth, resolving the data-center subdomain into the {dc}.api.mailchimp.com host, and mapping across its hundreds of campaign and audience endpoints yourself. Through Jentic you install once, import Mailchimp from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Mailchimp puts the list and campaign ids in the URL path (/lists/{list_id}/members, /campaigns/{campaign_id}/actions/send), so a rule can pin your agent to one audience or campaign. You choose the operations it may call, so sending a campaign is not included unless you add it.
- **Credential handling:** Your Mailchimp API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'add a subscriber to an audience' or 'send a campaign', and Jentic returns the matching Mailchimp operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Klaviyo API** — E-commerce-focused email and SMS marketing with advanced behavioral segmentation and revenue attribution
- **SendGrid Mail API** — High-volume transactional and marketing email delivery with granular deliverability controls
- **Constant Contact API** — Email marketing platform targeting small businesses with event marketing and social posting
- **HubSpot Marketing Emails** — Marketing email as part of the full HubSpot CRM and marketing automation suite
- **Segment API** — Customer data platform that routes behavioral events to Mailchimp and other marketing tools

## FAQ

### What authentication does the Mailchimp Marketing API use?

The Mailchimp Marketing API uses HTTP Basic authentication where the username can be any string and the password is your API key. Through Jentic, your Mailchimp API key is stored encrypted in your Jentic One instance. Agents receive scoped access tokens so the raw API key never enters the agent context.

### Can I send a campaign to a specific audience segment with the Mailchimp Marketing API?

Yes. Create a segment using POST /lists/{list_id}/segments with conditions like email engagement, purchase history, or merge field values. Then create a campaign with that segment as the recipient target and send it via POST /campaigns/{campaign_id}/actions/send. Segments support complex AND/OR condition groups.

### What are the rate limits for the Mailchimp Marketing API?

Mailchimp enforces a maximum of 10 simultaneous connections per user and a soft limit of approximately 10 requests per second. Batch operations via the /batches endpoint allow up to 500 operations per request, reducing the number of individual API calls needed for bulk subscriber imports or campaign updates.

### How do I track campaign open and click rates through Jentic?

Search Jentic for 'get campaign performance report' to find the GET /reports/{campaign_id} operation. Load the schema and execute to receive open rate, click rate, bounce rate, unsubscribe count, and per-link click data. Install the SDK with pip install jentic and use the search-load-execute flow to retrieve metrics programmatically.

### How many audience subscribers can the Mailchimp Marketing API handle?

The API supports audiences of any size within your Mailchimp plan limits. Free plans support up to 500 contacts, while paid plans scale to millions. The GET /lists/{list_id}/members endpoint paginates results with count and offset parameters, supporting up to 1000 members per page.

### Can I trigger automations via the Mailchimp Marketing API?

You can start and pause automation workflows using POST /automations/{workflow_id}/actions/start-all-emails and POST /automations/{workflow_id}/actions/pause-all-emails. To add subscribers to a running automation queue, use POST /automations/{workflow_id}/emails/{workflow_email_id}/queue with the subscriber email address.

### How do I import subscribers in bulk using the Mailchimp Marketing API?

Use the /batches endpoint to submit up to 500 subscriber operations in a single request. Each operation specifies the HTTP method, path (e.g., POST /lists/{list_id}/members), and body with subscriber data including email, status, and merge fields. Check batch status via GET /batches/{batch_id} until processing completes.

### Can I limit what my agent is allowed to do with the Mailchimp Marketing API?

Yes. Because you run Jentic One yourself, your own rules decide which Mailchimp operations and which stored API key the agent may use. Since Mailchimp puts the audience and campaign identifiers in the URL path, such as /lists/{list_id}/members and /campaigns/{campaign_id}/actions/send, you can pin an agent to a single audience or campaign. You also pick the exact operations it can call, so a send like POST /campaigns/{campaign_id}/actions/send stays off limits unless you add it.