CUcustomer
Email link and publish

Link an email to a workflow

Changed on

Link a Design Studio email to a workflow: a transactional message, a one-time send, an automation, or an API-triggered broadcast. After you link an email, publish it to push the content live.

You can only link an email to one workflow or action at a time. If the workflow or action is already linked to a different Design Studio email, the request fails with a 409 unless you pass "force": true, which replaces (and unlinks) the other email.

post/v1/design_studio/emails/{id}/link

Request

  • Base URL
    https://api.customer.io
  • URL
    https://api.customer.io/v1/design_studio/emails/{id}/link
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

The id of the email. If your email has multiple languages, you must provide the ID of the default language template. This links the workflow to all of the language variants for the template.

Request body

forceboolean

Replace an existing link if the workflow or action is already linked to different Design Studio content.

Example request

{
  "target": {
    "type": "campaign_action",
    "action_id": 42
  },
  "force": false
}

Response

Email linked

node_idstring uuid

The UUID of the linked message.

template_idinteger

The ID of the workflow template the content is now linked to.

Example response

{
  "node_id": "123e4567-e89b-12d3-a456-426614174000",
  "template_id": 987654,
  "target": {
    "type": "campaign_action",
    "action_id": 42
  }
}

Changes

  • 6378ded43e43Revision changes
    • info

      the endpoint scheme security Bearer-Auth was added to the API

    • info

      api tag Email link and publish added

    • info

      api tag Design Studio emails removed

  • b0a0db5fbc21Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status