Mailchimp Marketing API
OpenAPI 3.1 coverage for Mailchimp Marketing API audience, member, campaign, and reporting operations. Replace the data-center server variable with the account data center before calling.
Connect this API to an AI agent Browse all specs
What you can do with Mailchimp Marketing API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | / |
get | List API root resources Method: GET Path: / |
| GET | /lists |
getLists | List audiences Method: GET Path: /lists IMPORTANT: This function has 0 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - count: count parameter. - offset: offset parameter. |
| GET | /lists/{list_id} |
getListsByListId | Get an audience Method: GET Path: /lists/{list_id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - list_id: list_id parameter. |
| GET | /lists/{list_id}/members |
getListsByListIdMembers | List audience members Method: GET Path: /lists/{list_id}/members IMPORTANT: This function has 1 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - list_id: list_id parameter. Query Parameters: OPTIONAL: - count: count parameter. - offset: offset parameter. |
| POST | /lists/{list_id}/members |
postListsByListIdMembers | Add an audience member Method: POST Path: /lists/{list_id}/members IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - list_id: list_id parameter. Request Body: REQUIRED: - body: Request body (application/json) |
| GET | /lists/{list_id}/members/{subscriber_hash} |
getListsByListIdMembersBySubscriberHash | Get an audience member Method: GET Path: /lists/{list_id}/members/{subscriber_hash} IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - list_id: list_id parameter. - subscriber_hash: subscriber_hash parameter. |
| PATCH | /lists/{list_id}/members/{subscriber_hash} |
patchListsByListIdMembersBySubscriberHash | Update an audience member Method: PATCH Path: /lists/{list_id}/members/{subscriber_hash} IMPORTANT: This function has 3 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - list_id: list_id parameter. - subscriber_hash: subscriber_hash parameter. Request Body: REQUIRED: - body: Request body (application/json) |
| DELETE | /lists/{list_id}/members/{subscriber_hash} |
deleteListsByListIdMembersBySubscriberHash | Archive an audience member Method: DELETE Path: /lists/{list_id}/members/{subscriber_hash} IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - list_id: list_id parameter. - subscriber_hash: subscriber_hash parameter. |
| GET | /campaigns |
getCampaigns | List campaigns Method: GET Path: /campaigns IMPORTANT: This function has 0 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - count: count parameter. - offset: offset parameter. |
| POST | /campaigns |
postCampaigns | Create a campaign Method: POST Path: /campaigns IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - body: Request body (application/json) |
| GET | /campaigns/{campaign_id} |
getCampaignsByCampaignId | Get a campaign Method: GET Path: /campaigns/{campaign_id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - campaign_id: campaign_id parameter. |
| PATCH | /campaigns/{campaign_id} |
patchCampaignsByCampaignId | Update a campaign Method: PATCH Path: /campaigns/{campaign_id} IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - campaign_id: campaign_id parameter. Request Body: REQUIRED: - body: Request body (application/json) |
| DELETE | /campaigns/{campaign_id} |
deleteCampaignsByCampaignId | Delete a campaign Method: DELETE Path: /campaigns/{campaign_id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - campaign_id: campaign_id parameter. |
| GET | /reports |
getReports | List campaign reports Method: GET Path: /reports IMPORTANT: This function has 0 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - count: count parameter. - offset: offset parameter. |
Usage guide
## Mailchimp Marketing API This listing describes documented production API routes only. Before making requests, read the provider's official documentation and configure the server URL variables where applicable. ### Authentication Create an API key under the Mailchimp account profile or complete OAuth for an integration. Replace the `{dc}` server variable with the account data-center prefix. The API supports HTTP Basic with any username and the API key as the password, or a Bearer token for OAuth. ### Operational guidance Use pagination for collection endpoints, respect provider rate limits, validate identifiers before mutating resources, and follow each provider's terms, consent requirements, and data-retention policies.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Mailchimp Marketing API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.