Mailchimp Marketing API

Name: Mailchimp Marketing API
Brand: Mailchimp Marketing API
Availability: InStock

✓ 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.

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with Mailchimp Marketing API

Explore with Jentic

View OpenAPI Document

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

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

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.

Intent-based discovery

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.

Time to first call

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 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.

Mailchimp Marketing API

Connect the Mailchimp Marketing API to your agent

Capabilities

Start building with Mailchimp Marketing API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs