Mailchimp

Mailchimp Automations API

The Automations API from Mailchimp — 13 operation(s) for automations.

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 36

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 /automations List classic automations · List automations #
Ask an LLM
“What classic automations are set up in my Mailchimp account?”
“Can I list only the automations that are currently sending?”
Tell an agent
List my classic automations.
List automations with status {status}.
POST /automations Create a classic automation · Add automation #
Ask an LLM
“How do I create a new classic automation workflow?”
“Can I set the trigger for an automation when I create it?”
Tell an agent
Create a classic automation for recipients {recipients} with trigger {trigger_settings}.
Set up a new automation using trigger {trigger_settings}, recipients {recipients} and settings {settings}.
GET /automations/{workflow_id} Get details of one automation workflow · Get automation info #
Ask an LLM
“What are the settings and trigger of a specific automation?”
“Can I look up a single automation workflow's status?”
Tell an agent
Get automation workflow {workflow_id}.
Show the trigger settings of automation {workflow_id}.
POST /automations/{workflow_id}/actions/pause-all-emails Pause every email in an automation · Pause automation emails #
Ask an LLM
“How do I pause an entire automation workflow at once?”
“Can I stop all emails in an automation without archiving it?”
Tell an agent
Pause all emails in automation {workflow_id}.
Halt the whole automation workflow {workflow_id}.
POST /automations/{workflow_id}/actions/start-all-emails Start every email in an automation · Start automation emails #
Ask an LLM
“How do I turn on all emails in an automation workflow?”
“Can I restart a whole paused automation in one call?”
Tell an agent
Start all emails in automation {workflow_id}.
Activate the entire automation workflow {workflow_id}.
POST /automations/{workflow_id}/actions/archive Archive an automation permanently · Archive automation #
Ask an LLM
“Can I permanently end an automation but keep its report data?”
“What happens to an automation once it is archived — can it be restarted?”
Tell an agent destructive · confirm first
Archive automation {workflow_id}.
Permanently end automation workflow {workflow_id} and keep its reports.
GET /automations/{workflow_id}/emails List the emails in an automation · List automated emails #
Ask an LLM
“Which emails make up a particular automation workflow?”
“How many emails are in one of my automations?”
Tell an agent
List the emails in automation {workflow_id}.
Show every step email of workflow {workflow_id}.
GET /automations/{workflow_id}/emails/{workflow_email_id} Get one email in an automation · Get workflow email info #
Ask an LLM
“What are the settings of a single email inside an automation?”
“Can I check the delay and subject for one automated email?”
Tell an agent
Get email {workflow_email_id} in automation {workflow_id}.
Show the details of automated email {workflow_email_id} from workflow {workflow_id}.
DELETE /automations/{workflow_id}/emails/{workflow_email_id} Delete an email from an automation · Delete workflow email #
Ask an LLM
“How do I remove one email from an automation workflow?”
“Why can't I delete an email from an abandoned cart automation?”
Tell an agent destructive · confirm first
Delete email {workflow_email_id} from automation {workflow_id}.
Remove step email {workflow_email_id} from workflow {workflow_id}.
PATCH /automations/{workflow_id}/emails/{workflow_email_id} Update an automated email's settings or delay · Update workflow email #
Ask an LLM
“Can I change the subject line or delay of an email in a welcome automation?”
“Which automation types let me edit their email settings through the API?”
Tell an agent
Update the delay of email {workflow_email_id} in automation {workflow_id} to {delay}.
Change the settings of automated email {workflow_email_id} in workflow {workflow_id} to {settings}.
GET /automations/{workflow_id}/emails/{workflow_email_id}/queue List subscribers queued for an automated email · List automated email subscribers #
Ask an LLM
“Who is waiting in the queue to receive an automated email?”
“How many subscribers are lined up for the next email in a workflow?”
Tell an agent
List the queue for email {workflow_email_id} in automation {workflow_id}.
Show subscribers waiting on automated email {workflow_email_id} of workflow {workflow_id}.
POST /automations/{workflow_id}/emails/{workflow_email_id}/queue Add a subscriber to an automated email queue · Add subscriber to workflow email #
Ask an LLM
“Can I manually push a subscriber into an automation without waiting for the trigger?”
“How do I trigger an API 3.0 automation series for a specific email address?”
Tell an agent
Add {email_address} to the queue for email {workflow_email_id} in automation {workflow_id}.
Trigger automated email {workflow_email_id} of workflow {workflow_id} for {email_address}.
GET /automations/{workflow_id}/emails/{workflow_email_id}/queue/{subscriber_hash} Get one subscriber in an automated email queue · Get automated email subscriber #
Ask an LLM
“Is a specific subscriber queued for an automated email, and when will it send?”
“Can I check one person's place in an automation email queue?”
Tell an agent
Get queued subscriber {subscriber_hash} for email {workflow_email_id} in automation {workflow_id}.
Check when {subscriber_hash} will get automated email {workflow_email_id} of workflow {workflow_id}.
POST /automations/{workflow_id}/emails/{workflow_email_id}/actions/pause Pause a single automated email · Pause automated email #
Ask an LLM
“Can I pause just one email in an automation and leave the rest running?”
“How do I hold a single step of a workflow?”
Tell an agent
Pause automated email {workflow_email_id} in workflow {workflow_id}.
Stop only step {workflow_email_id} of automation {workflow_id} from sending.
POST /automations/{workflow_id}/emails/{workflow_email_id}/actions/start Start a single automated email · Start automated email #
Ask an LLM
“How do I turn on one individual email in an automation?”
“Can I resume a single paused step of a workflow?”
Tell an agent
Start automated email {workflow_email_id} in workflow {workflow_id}.
Turn on only step {workflow_email_id} of automation {workflow_id}.
GET /automations/{workflow_id}/removed-subscribers List subscribers removed from an automation · List subscribers removed from workflow #
Ask an LLM
“Which subscribers have been taken out of an automation workflow?”
“Can I see everyone who was removed from a workflow?”
Tell an agent
List subscribers removed from automation {workflow_id}.
Show everyone pulled out of workflow {workflow_id}.
POST /automations/{workflow_id}/removed-subscribers Remove a subscriber from an automation · Remove subscriber from workflow #
Ask an LLM
“How do I stop one subscriber from getting any more emails in an automation?”
“Can someone removed from a workflow ever be added back?”
Tell an agent destructive · confirm first
Remove {email_address} from automation {workflow_id}.
Take {email_address} out of workflow {workflow_id} permanently.
GET /automations/{workflow_id}/removed-subscribers/{subscriber_hash} Get one subscriber removed from an automation · Get subscriber removed from workflow #
Ask an LLM
“Was a specific subscriber removed from an automation workflow?”
“Can I confirm one person's removal from a workflow?”
Tell an agent
Get removed subscriber {subscriber_hash} from automation {workflow_id}.
Confirm that {subscriber_hash} was removed from workflow {workflow_id}.
GET /3.0/automations List automations #
POST /3.0/automations Add automation #
GET /3.0/automations/{workflow_id} Get automation info #
POST /3.0/automations/{workflow_id}/actions/archive Archive automation #
POST /3.0/automations/{workflow_id}/actions/pause-all-emails Pause automation emails #
POST /3.0/automations/{workflow_id}/actions/start-all-emails Start automation emails #
GET /3.0/automations/{workflow_id}/emails List automated emails #
DELETE /3.0/automations/{workflow_id}/emails/{workflow_email_id} Delete workflow email #
GET /3.0/automations/{workflow_id}/emails/{workflow_email_id} Get workflow email info #
PATCH /3.0/automations/{workflow_id}/emails/{workflow_email_id} Update workflow email #
POST /3.0/automations/{workflow_id}/emails/{workflow_email_id}/actions/pause Pause automated email #
POST /3.0/automations/{workflow_id}/emails/{workflow_email_id}/actions/start Start automated email #
GET /3.0/automations/{workflow_id}/emails/{workflow_email_id}/queue List automated email subscribers #
POST /3.0/automations/{workflow_id}/emails/{workflow_email_id}/queue Add subscriber to workflow email #
GET /3.0/automations/{workflow_id}/emails/{workflow_email_id}/queue/{subscriber_hash} Get automated email subscriber #
GET /3.0/automations/{workflow_id}/removed-subscribers List subscribers removed from workflow #
POST /3.0/automations/{workflow_id}/removed-subscribers Remove subscriber from workflow #
GET /3.0/automations/{workflow_id}/removed-subscribers/{subscriber_hash} Get subscriber removed from workflow #

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-automations-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-automations-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-automations-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mailchimp Automations 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 automations 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 (2529 KB total) ---
# Full source: https://artifacts.apis.io/mailchimp/openapi/mailchimp-automations-api-openapi.yml