Mailchimp · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for Mailchimp Marketing Automations API
19 actions
19 updates
phrasing
extends
openapi/mailchimp-automations-api-openapi.yml
Generated by API Evangelist
Written by API Evangelist tooling for Mailchimp's API. It is a proposal applied on top of the contract, not a document Mailchimp publishes.
What the actions change
x-apievangelist-phrasing
Targets 19 · first 16 shown; the file carries all of them
$.info
$.paths['/automations'].get
$.paths['/automations'].post
$.paths['/automations/{workflow_id}'].get
$.paths['/automations/{workflow_id}/actions/pause-all-emails'].post
$.paths['/automations/{workflow_id}/actions/start-all-emails'].post
$.paths['/automations/{workflow_id}/actions/archive'].post
$.paths['/automations/{workflow_id}/emails'].get
$.paths['/automations/{workflow_id}/emails/{workflow_email_id}'].get
$.paths['/automations/{workflow_id}/emails/{workflow_email_id}'].delete
$.paths['/automations/{workflow_id}/emails/{workflow_email_id}'].patch
$.paths['/automations/{workflow_id}/emails/{workflow_email_id}/queue'].get
$.paths['/automations/{workflow_id}/emails/{workflow_email_id}/queue'].post
$.paths['/automations/{workflow_id}/emails/{workflow_email_id}/queue/{subscriber_hash}'].get
$.paths['/automations/{workflow_id}/emails/{workflow_email_id}/actions/pause'].post
$.paths['/automations/{workflow_id}/emails/{workflow_email_id}/actions/start'].post
OpenAPI Overlay
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for Mailchimp Marketing Automations API
version: 1.0.0
extends: openapi/mailchimp-automations-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-09-26'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 18
- target: $.paths['/automations'].get
update:
x-apievangelist-phrasing:
intent: List classic automations
effect: read
questions:
- What classic automations are set up in my Mailchimp account?
- Can I list only the automations that are currently sending?
- Which automations were created after a certain date?
instructions:
- text: List my classic automations.
- text: List automations with status {status}.
slots:
status: query.status
method: generated
generated: '2026-09-26'
- target: $.paths['/automations'].post
update:
x-apievangelist-phrasing:
intent: Create a classic automation
effect: write
questions:
- How do I create a new classic automation workflow?
- Can I set the trigger for an automation when I create it?
instructions:
- text: Create a classic automation for recipients {recipients} with trigger {trigger_settings}.
slots:
recipients: requestBody.recipients
trigger_settings: requestBody.trigger_settings
- text: Set up a new automation using trigger {trigger_settings}, recipients {recipients} and settings {settings}.
slots:
trigger_settings: requestBody.trigger_settings
recipients: requestBody.recipients
settings: requestBody.settings
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}'].get
update:
x-apievangelist-phrasing:
intent: Get details of one automation workflow
effect: read
questions:
- What are the settings and trigger of a specific automation?
- Can I look up a single automation workflow's status?
instructions:
- text: Get automation workflow {workflow_id}.
slots:
workflow_id: path.workflow_id
- text: Show the trigger settings of automation {workflow_id}.
slots:
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/actions/pause-all-emails'].post
update:
x-apievangelist-phrasing:
intent: Pause every email in an automation
effect: write
questions:
- How do I pause an entire automation workflow at once?
- Can I stop all emails in an automation without archiving it?
instructions:
- text: Pause all emails in automation {workflow_id}.
slots:
workflow_id: path.workflow_id
- text: Halt the whole automation workflow {workflow_id}.
slots:
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/actions/start-all-emails'].post
update:
x-apievangelist-phrasing:
intent: Start every email in an automation
effect: write
questions:
- How do I turn on all emails in an automation workflow?
- Can I restart a whole paused automation in one call?
instructions:
- text: Start all emails in automation {workflow_id}.
slots:
workflow_id: path.workflow_id
- text: Activate the entire automation workflow {workflow_id}.
slots:
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/actions/archive'].post
update:
x-apievangelist-phrasing:
intent: Archive an automation permanently
effect: destructive
questions:
- Can I permanently end an automation but keep its report data?
- What happens to an automation once it is archived — can it be restarted?
instructions:
- text: Archive automation {workflow_id}.
slots:
workflow_id: path.workflow_id
- text: Permanently end automation workflow {workflow_id} and keep its reports.
slots:
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/emails'].get
update:
x-apievangelist-phrasing:
intent: List the emails in an automation
effect: read
questions:
- Which emails make up a particular automation workflow?
- How many emails are in one of my automations?
instructions:
- text: List the emails in automation {workflow_id}.
slots:
workflow_id: path.workflow_id
- text: Show every step email of workflow {workflow_id}.
slots:
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/emails/{workflow_email_id}'].get
update:
x-apievangelist-phrasing:
intent: Get one email in an automation
effect: read
questions:
- What are the settings of a single email inside an automation?
- Can I check the delay and subject for one automated email?
instructions:
- text: Get email {workflow_email_id} in automation {workflow_id}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
- text: Show the details of automated email {workflow_email_id} from workflow {workflow_id}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/emails/{workflow_email_id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete an email from an automation
effect: destructive
questions:
- How do I remove one email from an automation workflow?
- Why can't I delete an email from an abandoned cart automation?
instructions:
- text: Delete email {workflow_email_id} from automation {workflow_id}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
- text: Remove step email {workflow_email_id} from workflow {workflow_id}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/emails/{workflow_email_id}'].patch
update:
x-apievangelist-phrasing:
intent: Update an automated email's settings or delay
effect: write
questions:
- 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?
instructions:
- text: Update the delay of email {workflow_email_id} in automation {workflow_id} to {delay}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
delay: requestBody.delay
- text: Change the settings of automated email {workflow_email_id} in workflow {workflow_id} to {settings}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
settings: requestBody.settings
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/emails/{workflow_email_id}/queue'].get
update:
x-apievangelist-phrasing:
intent: List subscribers queued for an automated email
effect: read
questions:
- Who is waiting in the queue to receive an automated email?
- How many subscribers are lined up for the next email in a workflow?
instructions:
- text: List the queue for email {workflow_email_id} in automation {workflow_id}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
- text: Show subscribers waiting on automated email {workflow_email_id} of workflow {workflow_id}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/emails/{workflow_email_id}/queue'].post
update:
x-apievangelist-phrasing:
intent: Add a subscriber to an automated email queue
effect: write
questions:
- 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?
instructions:
- text: Add {email_address} to the queue for email {workflow_email_id} in automation {workflow_id}.
slots:
email_address: requestBody.email_address
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
- text: Trigger automated email {workflow_email_id} of workflow {workflow_id} for {email_address}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
email_address: requestBody.email_address
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/emails/{workflow_email_id}/queue/{subscriber_hash}'].get
update:
x-apievangelist-phrasing:
intent: Get one subscriber in an automated email queue
effect: read
questions:
- 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?
instructions:
- text: Get queued subscriber {subscriber_hash} for email {workflow_email_id} in automation {workflow_id}.
slots:
subscriber_hash: path.subscriber_hash
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
- text: Check when {subscriber_hash} will get automated email {workflow_email_id} of workflow {workflow_id}.
slots:
subscriber_hash: path.subscriber_hash
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/emails/{workflow_email_id}/actions/pause'].post
update:
x-apievangelist-phrasing:
intent: Pause a single automated email
effect: write
questions:
- Can I pause just one email in an automation and leave the rest running?
- How do I hold a single step of a workflow?
instructions:
- text: Pause automated email {workflow_email_id} in workflow {workflow_id}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
- text: Stop only step {workflow_email_id} of automation {workflow_id} from sending.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/emails/{workflow_email_id}/actions/start'].post
update:
x-apievangelist-phrasing:
intent: Start a single automated email
effect: write
questions:
- How do I turn on one individual email in an automation?
- Can I resume a single paused step of a workflow?
instructions:
- text: Start automated email {workflow_email_id} in workflow {workflow_id}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
- text: Turn on only step {workflow_email_id} of automation {workflow_id}.
slots:
workflow_email_id: path.workflow_email_id
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/removed-subscribers'].get
update:
x-apievangelist-phrasing:
intent: List subscribers removed from an automation
effect: read
questions:
- Which subscribers have been taken out of an automation workflow?
- Can I see everyone who was removed from a workflow?
instructions:
- text: List subscribers removed from automation {workflow_id}.
slots:
workflow_id: path.workflow_id
- text: Show everyone pulled out of workflow {workflow_id}.
slots:
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/removed-subscribers'].post
update:
x-apievangelist-phrasing:
intent: Remove a subscriber from an automation
effect: destructive
questions:
- How do I stop one subscriber from getting any more emails in an automation?
- Can someone removed from a workflow ever be added back?
instructions:
- text: Remove {email_address} from automation {workflow_id}.
slots:
email_address: requestBody.email_address
workflow_id: path.workflow_id
- text: Take {email_address} out of workflow {workflow_id} permanently.
slots:
email_address: requestBody.email_address
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
- target: $.paths['/automations/{workflow_id}/removed-subscribers/{subscriber_hash}'].get
update:
x-apievangelist-phrasing:
intent: Get one subscriber removed from an automation
effect: read
questions:
- Was a specific subscriber removed from an automation workflow?
- Can I confirm one person's removal from a workflow?
instructions:
- text: Get removed subscriber {subscriber_hash} from automation {workflow_id}.
slots:
subscriber_hash: path.subscriber_hash
workflow_id: path.workflow_id
- text: Confirm that {subscriber_hash} was removed from workflow {workflow_id}.
slots:
subscriber_hash: path.subscriber_hash
workflow_id: path.workflow_id
method: generated
generated: '2026-09-26'
Work with this as data
Every overlay 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 openapi overlays
4 MCP tools reach this
find_overlaysBrowse and filter every overlay in the catalog.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.
Call it yourself
curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/mailchimp-automations-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.