Mailchimp Actions API

swagger: '2.0'
info:
  version: 3.0.55
  title: Mailchimp Marketing Abuse Actions API
  contact:
    name: Mailchimp API Support
    email: apihelp@mailchimp.com
  x-permalink: https://github.com/mailchimp/mailchimp-client-lib-codegen/blob/main/spec/marketing.json
  description: '

    The Mailchimp Marketing API provides programmatic access to Mailchimp data

    and functionality, allowing developers to build custom features to do

    things like sync email activity and campaign analytics with their

    database, manage audiences and campaigns, and more.'
host: server.api.mailchimp.com
basePath: /3.0
schemes:
- https
consumes:
- application/json
produces:
- application/json
- application/problem+json
security:
- basicAuth: []
tags:
- name: Actions
paths:
  /automations/{workflow_id}/actions/pause-all-emails:
    post:
      summary: Mailchimp Pause Automation Emails
      description: Pause all emails in a specific classic automation workflow.
      operationId: postAutomationsIdActionsPauseAllEmails
      parameters:
      - in: path
        name: workflow_id
        type: string
        required: true
        description: The unique id for the Automation workflow.
        example: '500123'
      responses:
        '204':
          description: Empty Response
        default:
          description: An error generated by the Mailchimp API.
          schema:
            type: object
            title: Problem Detail Document
            description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
            required:
            - type
            - title
            - status
            - detail
            - instance
            properties:
              type:
                type: string
                title: Problem Type
                description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                example: https://mailchimp.com/developer/marketing/docs/errors/
              title:
                type: string
                title: Error Title
                description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                example: Resource Not Found
              status:
                type: integer
                title: HTTP Status Code
                description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                example: 404
              detail:
                type: string
                title: Error Message
                description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                example: The requested resource could not be found.
              instance:
                type: string
                title: Instance ID
                description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
      deprecated: false
      tags:
      - Actions
      x-custom-config:
        methodNameSnake: pause_all_emails
        methodNameCamel: pauseAllEmails
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /automations/{workflow_id}/actions/start-all-emails:
    post:
      summary: Mailchimp Start Automation Emails
      description: Start all emails in a classic automation workflow.
      operationId: postAutomationsIdActionsStartAllEmails
      parameters:
      - in: path
        name: workflow_id
        type: string
        required: true
        description: The unique id for the Automation workflow.
        example: '500123'
      responses:
        '204':
          description: Empty Response
        default:
          description: An error generated by the Mailchimp API.
          schema:
            type: object
            title: Problem Detail Document
            description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
            required:
            - type
            - title
            - status
            - detail
            - instance
            properties:
              type:
                type: string
                title: Problem Type
                description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                example: https://mailchimp.com/developer/marketing/docs/errors/
              title:
                type: string
                title: Error Title
                description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                example: Resource Not Found
              status:
                type: integer
                title: HTTP Status Code
                description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                example: 404
              detail:
                type: string
                title: Error Message
                description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                example: The requested resource could not be found.
              instance:
                type: string
                title: Instance ID
                description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
      deprecated: false
      tags:
      - Actions
      x-custom-config:
        methodNameSnake: start_all_emails
        methodNameCamel: startAllEmails
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /automations/{workflow_id}/actions/archive:
    post:
      summary: Mailchimp Archive Automation
      description: Archiving will permanently end your automation and keep the report data. Youll be able to replicate your archived automation, but you cant restart it.
      operationId: archiveAutomations
      parameters:
      - in: path
        name: workflow_id
        type: string
        required: true
        description: The unique id for the Automation workflow.
        example: '500123'
      responses:
        '204':
          description: Empty Response
        default:
          description: An error generated by the Mailchimp API.
          schema:
            type: object
            title: Problem Detail Document
            description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
            required:
            - type
            - title
            - status
            - detail
            - instance
            properties:
              type:
                type: string
                title: Problem Type
                description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                example: https://mailchimp.com/developer/marketing/docs/errors/
              title:
                type: string
                title: Error Title
                description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                example: Resource Not Found
              status:
                type: integer
                title: HTTP Status Code
                description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                example: 404
              detail:
                type: string
                title: Error Message
                description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                example: The requested resource could not be found.
              instance:
                type: string
                title: Instance ID
                description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
      deprecated: false
      tags:
      - Actions
      x-custom-config:
        methodNameSnake: archive
        methodNameCamel: archive
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /automations/{workflow_id}/emails/{workflow_email_id}/actions/pause:
    post:
      summary: Mailchimp Pause Automated Email
      description: Pause an automated email.
      operationId: postAutomationsIdEmailsIdActionsPause
      parameters:
      - in: path
        name: workflow_id
        type: string
        required: true
        description: The unique id for the Automation workflow.
        example: '500123'
      - in: path
        name: workflow_email_id
        type: string
        required: true
        description: The unique id for the Automation workflow email.
        example: user@example.com
      responses:
        '204':
          description: Empty Response
        default:
          description: An error generated by the Mailchimp API.
          schema:
            type: object
            title: Problem Detail Document
            description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
            required:
            - type
            - title
            - status
            - detail
            - instance
            properties:
              type:
                type: string
                title: Problem Type
                description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                example: https://mailchimp.com/developer/marketing/docs/errors/
              title:
                type: string
                title: Error Title
                description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                example: Resource Not Found
              status:
                type: integer
                title: HTTP Status Code
                description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                example: 404
              detail:
                type: string
                title: Error Message
                description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                example: The requested resource could not be found.
              instance:
                type: string
                title: Instance ID
                description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
      deprecated: false
      tags:
      - Actions
      x-custom-config:
        methodNameSnake: pause_workflow_email
        methodNameCamel: pauseWorkflowEmail
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /automations/{workflow_id}/emails/{workflow_email_id}/actions/start:
    post:
      summary: Mailchimp Start Automated Email
      description: Start an automated email.
      operationId: postAutomationsIdEmailsIdActionsStart
      parameters:
      - in: path
        name: workflow_id
        type: string
        required: true
        description: The unique id for the Automation workflow.
        example: '500123'
      - in: path
        name: workflow_email_id
        type: string
        required: true
        description: The unique id for the Automation workflow email.
        example: user@example.com
      responses:
        '204':
          description: Empty Response
        default:
          description: An error generated by the Mailchimp API.
          schema:
            type: object
            title: Problem Detail Document
            description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
            required:
            - type
            - title
            - status
            - detail
            - instance
            properties:
              type:
                type: string
                title: Problem Type
                description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                example: https://mailchimp.com/developer/marketing/docs/errors/
              title:
                type: string
                title: Error Title
                description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                example: Resource Not Found
              status:
                type: integer
                title: HTTP Status Code
                description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                example: 404
              detail:
                type: string
                title: Error Message
                description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                example: The requested resource could not be found.
              instance:
                type: string
                title: Instance ID
                description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
      deprecated: false
      tags:
      - Actions
      x-custom-config:
        methodNameSnake: start_workflow_email
        methodNameCamel: startWorkflowEmail
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /campaigns/{campaign_id}/actions/cancel-send:
    post:
      summary: Mailchimp Cancel Campaign
      description: Cancel a Regular or Plain-Text Campaign after you send, before all of your recipients receive it. This feature is included with Mailchimp Pro.
      operationId: postCampaignsIdActionsCancelSend
      x-pro-required: true
      parameters:
      - in: path
        name: campaign_id
        x-title: Campaign ID
        type: string
        required: true
        description: The unique id for the campaign.
        example: '500123'
      responses:
        '204':
          description: Empty Response
        default:
          description: An error generated by the Mailchimp API.
          schema:
            type: object
            title: Problem Detail Document
            description: An error generated by the Mailchimp API. Conforms to IETF draft 'draft-nottingham-http-problem-06'.
            required:
            - type
            - title
            - status
            - detail
            - instance
            properties:
              type:
                type: string
                title: Problem Type
                description: An absolute URI that identifies the problem type. When dereferenced, it should provide human-readable documentation for the problem type.
                example: https://mailchimp.com/developer/marketing/docs/errors/
              title:
                type: string
                title: Error Title
                description: A short, human-readable summary of the problem type. It shouldn't change based on the occurrence of the problem, except for purposes of localization.
                example: Resource Not Found
              status:
                type: integer
                title: HTTP Status Code
                description: The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurrence of the problem.
                example: 404
              detail:
                type: string
                title: Error Message
                description: A human-readable explanation specific to this occurrence of the problem. [Learn more about errors](/developer/guides/get-started-with-mailchimp-api-3/#Errors).
                example: The requested resource could not be found.
              instance:
                type: string
                title: Instance ID
                description: A string that identifies this specific occurrence of the problem. Please provide this ID when contacting support.
                example: 995c5cb0-3280-4a6e-808b-3b096d0bb219
      deprecated: false
      tags:
      - Actions
      x-custom-config:
        methodNameSnake: cancel_send
        methodNameCamel: cancelSend
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /campaigns/{campaign_id}/actions/replicate:
    post:
      summary: Mailchimp Replicate Campaign
      description: Replicate a campaign in saved or send status.
      operationId: postCampaignsIdActionsReplicate
      parameters:
      - in: path
        name: campaign_id
        x-title: Campaign ID
        type: string
        required: true
        description: The unique id for the campaign.
        example: '500123'
      responses:
        '200':
          description: ''
          schema:
            type: object
            title: Campaign
            description: A summary of an individual campaign's settings and content.
            required:
            - type
            properties:
              id:
                type: string
                title: Campaign ID
                description: A string that uniquely identifies this campaign.
                readOnly: true
              web_id:
                type: integer
                title: Campaign Web ID
                description: The ID used in the Mailchimp web application. View this campaign in your Mailchimp account at `https://{dc}.admin.mailchimp.com/campaigns/show/?id={web_id}`.
                readOnly: true
              parent_campaign_id:
                type: string
                title: Parent Campaign ID
                description: If this campaign is the child of another campaign, this identifies the parent campaign. For Example, for RSS or Automation children.
                readOnly: true
              type:
                type: string
                title: Campaign Type
                description: There are four types of [campaigns](https://mailchimp.com/help/getting-started-with-campaigns/) you can create in Mailchimp. A/B Split campaigns have been deprecated and variate campaigns should be used instead.
                enum:
                - regular
                - plaintext
                - absplit
                - rss
                - variate
              create_time:
                type: string
                format: date-time
                title: Create Time
                description: The date and time the campaign was created in ISO 8601 format.
                readOnly: true
              archive_url:
                type: string
                title: Archive URL
                description: The link to the campaign's archive version.
                readOnly: true
              long_archive_url:
                type: string
                title: Long Archive URL
                description: The original link to the campaign's archive version.
                readOnly: true
              status:
                type: string
                title: Campaign Status
                description: The current status of the campaign.
                enum:
                - save
                - paused
                - schedule
                - sending
                - sent
                - canceled
                - canceling
                - archived
                readOnly: true
              emails_sent:
                type: integer
                title: Emails Sent
                description: The total number of emails sent for this campaign.
                readOnly: true
              send_time:
                type: string
                format: date-time
                title: Send Time
                description: The date and time a campaign was sent in ISO 8601 format.
                readOnly: true
              content_type:
                type: string
                title: Content Type
                description: How the campaign's content is put together ('template', 'drag_and_drop', 'html', 'url').
                readOnly: true
              needs_block_refresh:
                type: boolean
                title: Needs Block Refresh
                description: Determines if the campaign needs its blocks refreshed by opening the web-based campaign editor. Deprecated and will always return false.
                readOnly: true
              resendable:
                type: boolean
                title: Resendable
                description: Determines if the campaign qualifies to be resent to non-openers.
                readOnly: true
              recipients:
                type: object
                title: List
                description: List settings for the campaign.
                required:
                - list_id
                properties:
                  list_id:
                    type: string
                    title: List ID
                    description: The unique list id.
                  list_name:
                    type: string
                    title: List Name
                    description: The name of the list.
                    readOnly: true
                  segment_text:
                    type: string
                    title: Segment Text
                    description: A description of the [segment](https://mailchimp.com/help/save-and-manage-segments/) used for the campaign. Formatted as a string marked up with HTML.
                    readOnly: true
                  recipient_count:
                    type: integer
                    title: Recipient Count
                    description: Count of the recipients on the associated list. Formatted as an integer.
                    readOnly: true
                  segment_opts:
                    type: object
                    title: Segment Options
                    description: An object representing all segmentation options. This object should contain a `saved_segment_id` to use an existing segment, or you can create a new segment by including both `match` and `conditions` options.
                    properties:
                      saved_segment_id:
                        type: integer
                        title: Saved Segment ID
                        description: The id for an existing saved segment.
                      prebuilt_segment_id:
                        type: string
                        title: Prebuilt Segment Id
                        description: The prebuilt segment id, if a prebuilt segment has been designated for this campaign.
                        example: subscribers-female
                      match:
                        type: string
                        title: Match Type
                        description: Segment match type.
                        enum:
                        - any
                        - all
                      conditions:
                        type: array
                        title: Segment Type
                        description: Segment match conditions. There are multiple possible types, see the [condition types documentation](https://mailchimp.com/developer/marketing/docs/alternative-schemas/#segment-condition-schemas).
                        items:
                          x-discriminator:
                            type: string
                            propertyName: condition_type
                          x-oneOf:
                          - type: object
                            title: Aim Segment
                            description: Segment by interaction with a specific campaign.
                            properties:
                              condition_type:
                                type: string
                                x-value: Aim
                                enum:
                                - Aim
                              field:
                                type: string
                                enum:
                                - aim
                                title: Segment Field
                                description: Segment by interaction with a specific campaign.
                                example: aim
                              op:
                                type: string
                                enum:
                                - open
                                - click
                                - sent
                                - noopen
                                - noclick
                                - nosent
                                title: Segment Operator
                                description: 'The status of the member with regard to their campaign interaction. One of the following: opened, clicked, was sent, didn''t open, didn''t click, or was not sent.'
                                example: open
                              value:
                                type: string
                                title: Segment Data
                                description: Either the web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns.
                                example: any
                          - type: object
                            title: Automation Segment
                            description: Segment by interaction with an Automation workflow.
                            required:
                            - field
                            - op
                            - value
                            properties:
                              condition_type:
                                type: string
                                x-value: Automation
                                enum:
                                - Automation
                              field:
                                type: string
                                enum:
                                - automation
                                title: Segment Field
                                description: Segment by interaction with an Automation workflow.
                                example: automation
                              op:
                                type: string
                                enum:
                                - started
                                - completed
                                - not_started
                                - not_completed
                                title: Segment Operator
                                description: 'The status of the member with regard to the automation workflow. One of the following: has started the workflow, has completed the workflow, has not started the workflow, or has not completed the workflow.'
                                example: started
                              value:
                                type: string
                                title: Segment Data
                                description: The web id for the automation workflow to segment against.
                                example: '2135217'
                          - type: object
                            title: Poll Activity Segment
                            description: Segment by poll activity.
                            required:
                            - field
                            - op
                            - value
                            properties:
                              condition_type:
                                type: string
                                x-value: CampaignPoll
                                enum:
                                - CampaignPoll
                              field:
                                type: string
                                enum:
                                - poll
                                title: Segment Field
                                description: Segment by poll activity.
                                example: poll
                              op:
                                type: string
                                enum:
                                - member
                                - notmember
                                title: Segment Operator
                                description: Members have/have not interacted with a specific poll in a Mailchimp email.
                                example: member
                              value:
                                type: number
                                title: Segment Operator
                                description: The id for the poll.
                                example: 409
                          - type: object
                            title: Conversation Segment
                            description: Segment by interaction with a campaign via Conversations.
                            required:
                            - field
                            - op
                            - value
                            properties:
                              condition_type:
                                type: string
                                x-value: Conversation
                                enum:
                                - Conversation
                              field:
                                type: string
                                enum:
                                - conversation
                                title: Segment Field
                                description: Segment by interaction with a campaign via Conversations.
                                example: conversation
                              op:
                                type: string
                                enum:
                                - member
                                - notmember
                                title: Segment Operator
                                description: 'The status of a member''s interaction with a conversation. One of the following: has replied or has not replied.'
                                example: member
                              value:
                                type: string
                                title: Segment Data
                                description: The web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns.
                                example: any
                          - type: object
                            title: Date Segment
                            description: Segment by a specific date field.
                            required:
                            - field
                            - op
                            - value
                            properties:
                              condition_type:
                                type: string
                                x-value: Date
                                enum:
                                - Date
                              field:
                                type: string
                                enum:
                                - timestamp_opt
                                - info_changed
                                - ecomm_date
                                title: Segment Field
                                description: 'The type of date field to se

# --- truncated at 32 KB (407 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mailchimp/refs/heads/main/openapi/mailchimp-actions-api-openapi.yml