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.
View Overlay File View on GitHub Overlay Specification

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

Raw ↑
# 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.
All 92 tools →

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.