Skip to content
Home/
/Workflows

Workflows

Export workflow configurations from your workspace.

Operations

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.

Preview API

This endpoint is available in the Preview API version. We may make iterative improvements, including adding new fields or refining existing ones.

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
Headers
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:Preview
curl -i -X GET \
  https://api.intercom.io/export/workflows/12345 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

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": []
  }
}