Mailchimp

Mailchimp Campaigns API

The Campaigns API from Mailchimp — 18 operation(s) for campaigns.

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 44

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /campaigns List email campaigns in the account · List campaigns #
Ask an LLM
“How do I see every campaign in my Mailchimp account?”
“Can I list only the campaigns that were sent after a certain date?”
Tell an agent
List all my campaigns.
List campaigns with status {status} sent since {since_send_time}.
POST /campaigns Create a new email campaign · Add campaign #
Ask an LLM
“How do I create a new regular email campaign through the API?”
“Can I set up an A/B test campaign when I first create it?”
Tell an agent
Create a new {type} campaign.
Create a {type} campaign aimed at recipients {recipients} with settings {settings}.
GET /campaigns/{campaign_id} Get details of one campaign · Get campaign info #
Ask an LLM
“Where can I look up the settings and status of a single campaign?”
“Can I check whether a specific campaign is eligible for the resend shortcut?”
Tell an agent
Get the details of campaign {campaign_id}.
Show the subject line and status of campaign {campaign_id}.
PATCH /campaigns/{campaign_id} Update an existing campaign's settings · Update campaign settings #
Ask an LLM
“How do I change the subject line or from name on a campaign I already created?”
“Can I switch the tracking options on an existing campaign?”
Tell an agent
Update the settings of campaign {campaign_id} to {settings}.
Change the recipients of existing campaign {campaign_id} to {recipients}, keeping settings {settings}.
DELETE /campaigns/{campaign_id} Delete a campaign · Delete campaign #
Ask an LLM
“How do I permanently remove a campaign from my account?”
“Can I delete an old draft campaign I no longer need?”
Tell an agent destructive · confirm first
Delete campaign {campaign_id}.
Remove the draft campaign {campaign_id} from my account.
POST /campaigns/{campaign_id}/actions/cancel-send Cancel a campaign that is mid-send · Cancel campaign #
Ask an LLM
“Can I stop a campaign after I hit send but before everyone receives it?”
“Is it possible to cancel a regular campaign that is already going out?”
Tell an agent destructive · confirm first
Cancel the in-progress send of campaign {campaign_id}.
Stop campaign {campaign_id} from reaching the rest of its recipients.
POST /campaigns/{campaign_id}/actions/replicate Duplicate a campaign · Replicate campaign #
Ask an LLM
“How do I make a copy of a campaign I already sent?”
“Can I clone a saved campaign to use as a starting point?”
Tell an agent
Replicate campaign {campaign_id}.
Make a duplicate copy of campaign {campaign_id}.
POST /campaigns/{campaign_id}/actions/send Send a campaign now · Send campaign #
Ask an LLM
“How do I send a campaign immediately instead of scheduling it?”
“What happens when I trigger send on an RSS campaign?”
Tell an agent
Send campaign {campaign_id} right now.
Launch campaign {campaign_id} to its audience immediately.
POST /campaigns/{campaign_id}/actions/schedule Schedule a campaign for later delivery · Schedule campaign #
Ask an LLM
“How do I schedule a campaign to go out at a specific time?”
“Can I use Timewarp so recipients get the email in their own time zone?”
Tell an agent
Schedule campaign {campaign_id} for {schedule_time}.
Schedule campaign {campaign_id} at {schedule_time} with Timewarp set to {timewarp}.
POST /campaigns/{campaign_id}/actions/unschedule Unschedule a scheduled campaign · Unschedule campaign #
Ask an LLM
“Can I take a campaign off the schedule before it starts sending?”
“What do I do if I scheduled a campaign too early and need to pull it back?”
Tell an agent
Unschedule campaign {campaign_id}.
Remove the scheduled send time from campaign {campaign_id}.
POST /campaigns/{campaign_id}/actions/test Send a test email of a campaign · Send test email #
Ask an LLM
“How do I send myself a test version of a campaign before it goes live?”
“Can I send the plain-text version as a test instead of HTML?”
Tell an agent
Send a {send_type} test of campaign {campaign_id} to {test_emails}.
Email a preview of campaign {campaign_id} to {test_emails} as {send_type}.
POST /campaigns/{campaign_id}/actions/pause Pause an RSS-driven campaign · Pause rss campaign #
Ask an LLM
“Can I temporarily stop my RSS campaign from sending new posts?”
“How do I pause an RSS-to-email campaign?”
Tell an agent
Pause RSS campaign {campaign_id}.
Put the RSS-driven campaign {campaign_id} on hold.
POST /campaigns/{campaign_id}/actions/resume Resume a paused RSS campaign · Resume rss campaign #
Ask an LLM
“How do I restart an RSS campaign I paused?”
“Can a paused RSS-driven campaign pick back up where it left off?”
Tell an agent
Resume RSS campaign {campaign_id}.
Turn the paused RSS campaign {campaign_id} back on.
POST /campaigns/{campaign_id}/actions/create-resend Resend a campaign to non-openers or new subscribers · Resend campaign #
Ask an LLM
“Can I resend a campaign to people who didn't open it the first time?”
“Is there a shortcut to resend a campaign to subscribers who joined after it went out?”
Tell an agent
Create a resend of campaign {campaign_id} for non-openers.
Create a resend of campaign {campaign_id} using the {shortcut_type} shortcut.
GET /campaigns/{campaign_id}/content Get a campaign's HTML and plain-text content · Get campaign content #
Ask an LLM
“Where can I pull the HTML body of a campaign?”
“Can I read the plain-text version of an email I built?”
Tell an agent
Get the HTML and plain-text content of campaign {campaign_id}.
Show me the email body of campaign {campaign_id}.
PUT /campaigns/{campaign_id}/content Set the content of a campaign · Set campaign content #
Ask an LLM
“How do I upload my own HTML as the content of a campaign?”
“Can I import campaign content from a URL or build it from a template?”
Tell an agent
Set the HTML content of campaign {campaign_id} to {html}.
Import the content for campaign {campaign_id} from {url}.
GET /campaigns/{campaign_id}/feedback List team feedback on a campaign · List campaign feedback #
Ask an LLM
“What comments has my team left on a campaign draft?”
“Can I see all the review feedback for one campaign?”
Tell an agent
List all feedback comments on campaign {campaign_id}.
Show my team's review notes for campaign {campaign_id}.
POST /campaigns/{campaign_id}/feedback Leave feedback on a campaign · Add campaign feedback #
Ask an LLM
“How do I add a review comment to a campaign my colleague is building?”
“Can I attach feedback to a specific content block in a campaign?”
Tell an agent
Add the feedback "{message}" to campaign {campaign_id}.
Comment "{message}" on block {block_id} of campaign {campaign_id}.
GET /campaigns/{campaign_id}/feedback/{feedback_id} Get one feedback message on a campaign · Get campaign feedback message #
Ask an LLM
“Can I pull up a single feedback comment on a campaign by its id?”
“Is a particular review comment on my campaign marked complete?”
Tell an agent
Get feedback message {feedback_id} on campaign {campaign_id}.
Show the text of feedback {feedback_id} from campaign {campaign_id}.
PATCH /campaigns/{campaign_id}/feedback/{feedback_id} Edit or resolve a campaign feedback message · Update campaign feedback message #
Ask an LLM
“Can I mark a feedback comment on a campaign as resolved?”
“How do I edit the wording of feedback I already left?”
Tell an agent
Mark feedback {feedback_id} on campaign {campaign_id} as complete.
Change feedback {feedback_id} on campaign {campaign_id} to say "{message}".
DELETE /campaigns/{campaign_id}/feedback/{feedback_id} Delete a feedback message from a campaign · Delete campaign feedback message #
Ask an LLM
“How do I remove a feedback comment someone left on my campaign?”
“Can I delete a review note that is no longer relevant?”
Tell an agent destructive · confirm first
Delete feedback {feedback_id} from campaign {campaign_id}.
Remove review comment {feedback_id} on campaign {campaign_id}.
GET /campaigns/{campaign_id}/send-checklist Review a campaign's pre-send checklist · Get campaign send checklist #
Ask an LLM
“Is my campaign ready to send, or are there issues I need to fix first?”
“What problems does the send checklist flag for a campaign?”
Tell an agent
Run the send checklist for campaign {campaign_id}.
Check whether campaign {campaign_id} has any blocking issues before sending.
GET /3.0/campaigns List campaigns #
POST /3.0/campaigns Add campaign #
DELETE /3.0/campaigns/{campaign_id} Delete campaign #
GET /3.0/campaigns/{campaign_id} Get campaign info #
PATCH /3.0/campaigns/{campaign_id} Update campaign settings #
POST /3.0/campaigns/{campaign_id}/actions/cancel-send Cancel campaign #
POST /3.0/campaigns/{campaign_id}/actions/create-resend Resend campaign #
POST /3.0/campaigns/{campaign_id}/actions/pause Pause rss campaign #
POST /3.0/campaigns/{campaign_id}/actions/replicate Replicate campaign #
POST /3.0/campaigns/{campaign_id}/actions/resume Resume rss campaign #
POST /3.0/campaigns/{campaign_id}/actions/schedule Schedule campaign #
POST /3.0/campaigns/{campaign_id}/actions/send Send campaign #
POST /3.0/campaigns/{campaign_id}/actions/test Send test email #
POST /3.0/campaigns/{campaign_id}/actions/unschedule Unschedule campaign #
GET /3.0/campaigns/{campaign_id}/content Get campaign content #
PUT /3.0/campaigns/{campaign_id}/content Set campaign content #
GET /3.0/campaigns/{campaign_id}/feedback List campaign feedback #
POST /3.0/campaigns/{campaign_id}/feedback Add campaign feedback #
DELETE /3.0/campaigns/{campaign_id}/feedback/{feedback_id} Delete campaign feedback message #
GET /3.0/campaigns/{campaign_id}/feedback/{feedback_id} Get campaign feedback message #
PATCH /3.0/campaigns/{campaign_id}/feedback/{feedback_id} Update campaign feedback message #
GET /3.0/campaigns/{campaign_id}/send-checklist Get campaign send checklist #

Documentation

📖
Documentation
https://mailchimp.com/developer/marketing/docs/fundamentals/
📖
APIReference
https://mailchimp.com/developer/marketing/api/
📖
GettingStarted
https://mailchimp.com/developer/marketing/guides/quick-start/
📖
Authentication
https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/
📖
Documentation
https://mailchimp.com/developer/transactional/docs/fundamentals/
📖
GettingStarted
https://mailchimp.com/developer/transactional/guides/quick-start/
📖
Authentication
https://mailchimp.com/developer/transactional/docs/authentication-delivery/
📖
APIReference
https://mailchimp.com/developer/transactional/api/
📖
GettingStarted
https://mailchimp.com/developer/transactional/guides/send-first-email/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/mailchimp/openapi/mailchimp-campaigns-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/mailchimp/asyncapi/mailchimp-marketing-webhooks-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/campaign.json
📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/audience.json
📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/member.json
📊
JSONSchema
https://artifacts.apis.io/mailchimp/json-schema/template.json

Other Resources

🔗
JSONLD
https://artifacts.apis.io/mailchimp/json-ld/context.jsonld
🔗
Integrations
https://mailchimp.com/developer/marketing/docs/integrations/
🔗
ErrorCodes
https://mailchimp.com/developer/marketing/docs/errors/
🔗
E-Commerce
https://mailchimp.com/developer/marketing/docs/e-commerce/
🔗
Methods and Parameters
https://mailchimp.com/developer/marketing/docs/methods-parameters/
🔗
Webhooks
https://mailchimp.com/developer/transactional/docs/webhooks/
🔗
Outbound Email
https://mailchimp.com/developer/transactional/docs/outbound-email/
🔗
Tags and Metadata
https://mailchimp.com/developer/transactional/docs/tags-metadata/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mailchimp:mailchimp-campaigns-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mailchimp-campaigns-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mailchimp Campaigns API
  contact:
    name: Mailchimp API Support
    email: apihelp@mailchimp.com
  x-refined-note:
  - x-permalink differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged campaigns across 2 of this provider''s published API definitions: mailchimp-marketing-api-openapi-original.json, mailchimp-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://server.api.mailchimp.com/3.0
- description: Mailchimp API
  url: https://api.mailchimp.com
tags:


# --- truncated at 32 KB (3453 KB total) ---
# Full source: https://artifacts.apis.io/mailchimp/openapi/mailchimp-campaigns-api-openapi.yml