Customer.io
v1.0.0
OpenAPI 3.1.0

List automation actions

US region

Client Libraries
Shell Curl

List automation actions

​

Returns the operations in an automation workflow. Each object in the response represents an action or 'tile' in the automation builder.

This endpoint returns up to 10 actions at a time. If there is another page of results, the response will include a next string. Pass this string as the start parameter to get the next page of results.

You get the actions that have content, like messages, attribute updates, and events—not delays or flow control blocks like t/f branches.

If a message block contains multiple languages, this endpoint returns an object for each language variant. Each language variant includes the multi_language_branch_action_id property with the same value. Use this id to retrieve metrics for each language variant in a single request through Get automation action metrics.

Path Parameters
  • campaign_id
    Type: integer
    required

    The ID of the automation that you want to trigger or return information about.

Query Parameters
  • start
    Type: string

    The token for the page of results you want to return. Responses contain a next property. Use this property as the start value to return the next page of results.

Responses
  • application/json
  • 400

    The campaignID or actionID is invalid.

  • 404

    The automation and/or action do not exist.

  • application/json
Request Example for get/v1/campaigns/{campaign_id}/actions
curl https://api.customer.io/v1/campaigns/3/actions \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "actions": [
    {
      "bcc": "string",
      "body": "string",
      "body_amp": "string",
      "broadcast_id": 2,
      "campaign_id": 5,
      "cc": "string",
      "created": 1552341937,
      "deduplicate_id": "15:1492548073",
      "fake_bcc": true,
      "from": "sentFrom@example.com",
      "from_id": 1,
      "headers": "[{\"name\":\"X-Mailgun-Tag\",\"value\":\"my-cool-tag\"},{\"name\":\"X-Custom-Header\",\"value\":\"custom-value\"}]",
      "id": 96,
      "language": "fr",
      "layout": "string",
      "multi_language_branch_action_id": 23,
      "name": "Opening Message",
      "parent_action_id": 1,
      "preheader_text": "string",
      "preprocessor": "premailer",
      "recipient": "{{customer.email}}",
      "reply_to": "replyto@example.com",
      "reply_to_id": 38,
      "sending_state": "automatic",
      "subject": "Did you get that thing I sent you?",
      "type": "email",
      "updated": 1552341937
    }
  ],
  "next": "string"
}

Returns automation actions. Each object represents an individual action.