Export a workflow

Request

Export a workflow configuration by its ID. This endpoint returns the complete workflow definition including its steps, targeting rules, and attributes.

The id in the path is the workflow's ruleset ID, the number at the end of the workflow's URL in Intercom (https://app.intercom.com/a/apps/<app_id>/automation/workflows/<id>). The workflow.id in the response is a different ID, so don't pass it back as id.

This endpoint is designed for EU Data Act compliance, allowing customers to export their workflow configurations.

Security

bearerAuth

Path

idstringrequired

The ruleset ID of the workflow. This is the number at the end of the workflow's URL in Intercom, https://app.intercom.com/a/apps/<app_id>/automation/workflows/<id>. It is not the workflow.id returned in the response, so don't pass that value back here.

Example:12345

Intercom-Versionstring(intercom_version)

Intercom API version.
If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"

Example:2.17

curl -i -X GET \
  https://api.intercom.io/export/workflows/12345 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: 2.17'

Responses

Workflow exported successfully

Bodyapplication/json

export_versionstring

The version of the export format.

Example:"1.0"

exported_atstring, (date-time)

The timestamp when the export was generated.

Example:"2026-01-26T12:00:00Z"

app_idinteger

The workspace identifier.

Example:12345

workflowobject

The workflow configuration.

Response

{
  "export_version": "1.0",
  "exported_at": "2026-01-26T12:00:00Z",
  "app_id": 12345,
  "workflow": {
    "id": "67890",
    "title": "My Workflow",
    "description": "A workflow that handles customer inquiries",
    "trigger_type": "inbound_conversation",
    "state": "live",
    "target_channels": [ … ],
    "preferred_devices": [ … ],
    "created_at": "2025-06-15T10:30:00Z",
    "updated_at": "2026-01-20T14:45:00Z",
    "targeting": {},
    "snapshot": {},
    "attributes": [],
    "embedded_rules": []
  }
}