Add automation

POST

https://api.mailchimp.com/3.0/automations

POST

/3.0/automations

curl -X POST https://api.mailchimp.com/3.0/automations \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "recipients": {},
  "trigger_settings": {
    "workflow_type": "abandonedBrowse"
  }
}'

200Successful

{
  "_links": [
    {
      "href": "string",
      "method": "GET",
      "rel": "string",
      "schema": "string",
      "targetSchema": "string"
    }
  ],
  "create_time": "2024-01-15T09:30:00Z",
  "emails_sent": 1,
  "id": "string",
  "recipients": {
    "list_id": "string",
    "list_is_active": true,
    "list_name": "string",
    "segment_opts": [
      {
        "condition_type": "Aim",
        "field": "aim",
        "op": "open",
        "value": "any"
      }
    ],
    "store_id": "1a2df69xxx"
  },
  "report_summary": {
    "click_rate": 1.1,
    "clicks": 1,
    "open_rate": 1.1,
    "opens": 1,
    "subscriber_clicks": 1,
    "unique_opens": 1
  },
  "settings": {
    "authenticate": true,
    "auto_footer": true,
    "from_name": "string",
    "inline_css": true,
    "reply_to": "string",
    "title": "string",
    "to_name": "string",
    "use_conversation": true
  },
  "start_time": "2024-01-15T09:30:00Z",
  "status": "save",
  "tracking": {
    "capsule": {
      "notes": true
    },
    "clicktale": "string",
    "ecomm360": true,
    "goal_tracking": true,
    "google_analytics": "string",
    "html_clicks": true,
    "opens": true,
    "salesforce": {
      "campaign": true,
      "notes": true
    },
    "text_clicks": true
  },
  "trigger_settings": {
    "workflow_type": "abandonedBrowse",
    "runtime": {
      "days": [
        "sunday"
      ],
      "hours": {
        "type": "send_asap"
      }
    },
    "workflow_emails_count": 1,
    "workflow_title": "string"
  }
}

Create a new classic automation in your Mailchimp account.

Authentication

AuthorizationBearer

Authorization using a Mailchimp API key (a.k.a. Bearer token)

AuthorizationBearer

Authorization using OAuth

Request

A summary of an individual Automation workflow's settings and content.

recipientsobjectRequired

List settings for the Automation.

trigger_settingsobjectRequired

Trigger settings for the Automation.

settingsobjectOptional

The settings for the Automation workflow.

Response

This endpoint returns an object.

_linkslist of objectsOptionalRead-only

A list of link types and descriptions for the API schema documents.

create_timedatetimeOptionalRead-only

The date and time the Automation was created in ISO 8601 format.

emails_sentintegerOptionalRead-only

The total number of emails sent for the Automation.

idstringOptionalRead-only

A string that identifies the Automation.

recipientsobjectOptional

List settings for the Automation.

report_summaryobjectOptional

A summary of opens and clicks for sent campaigns.

settingsobjectOptional

The settings for the Automation workflow.

start_timedatetimeOptionalRead-only

The date and time the Automation was started in ISO 8601 format.

statusenumOptionalRead-only

The current status of the Automation.

Allowed values:

trackingobjectOptional

The tracking options for the Automation.

trigger_settingsobjectOptional

Available triggers for Automation workflows.