Mailchimp Marketing API
✓ Official Vendor SpecMarketingEmail Marketingbasic274 EndpointsREST
For Agents
Send email campaigns, manage subscriber lists, trigger automations, and retrieve audience engagement metrics. Covers 274 endpoints across campaigns, lists, templates, automations, and reporting.
Use for: I need to send an email campaign to a specific audience segment, I want to create an automation workflow triggered by new subscriber sign-ups, List all campaigns sent in the last 30 days with their open rates, Get the subscriber count and engagement stats for a specific audience list
Not supported: Does not handle transactional email delivery, SMS messaging, or CRM deal tracking — use for marketing email campaigns, audience management, and automation workflows only.
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.
Install Jentic One Beta
Connect the Mailchimp Marketing API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Mailchimp Marketing API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Mailchimp Marketing API.
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
Patterns agents use Mailchimp Marketing API for, with concrete tasks.
★ 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.
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.
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.
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.
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.
Create a new e-commerce store connection, import 50 products with variants, and set up an abandoned cart automation trigger
Key Endpoints
274 endpoints — send and track email campaigns, manage subscriber audiences, build automations, and analyze engagement across all marketing channels.
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
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
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Mailchimp Basic auth credentials (API key) are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — the raw API key and data center prefix never enter the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'send email campaign to segment') and Jentic returns matching Mailchimp operations with input schemas, so the agent can call the right endpoint without browsing Mailchimp's 274-endpoint documentation.
Time to first call
Direct Mailchimp integration: 2-4 days for auth setup, data center handling, webhook configuration, and pagination logic. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Mailchimp Marketing API through Jentic.
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 the MAXsystem vault. 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.
GET STARTED