Retrieve an execution result

REST API Reference

Request

Retrieve details for a specific data connector execution result. Includes the request/response bodies and sanitised request URL when they are available.

OAuth tokens must have the read_workflow_connector_execution_result or read_write_data_connectors scope.

Security

bearerAuth

Path

data_connector_idstringrequired

The unique identifier for the data connector.

Example:12345

idstringrequired

The unique identifier for the execution result.

Example:99001

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/data_connectors/12345/execution_results/99001 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: 2.17'

Responses

successful

Bodyapplication/json

typestring

The type of object - data_connector.execution.

Value:"data_connector.execution"

Example:"data_connector.execution"

idstring

The unique identifier for the execution result.

Example:"99001"

data_connector_idstring

The unique identifier of the data connector that produced this result.

Example:"12345"

successboolean

Whether the execution was successful.

Example:true

http_statusinteger or null

The HTTP status code returned by the external API.

Example:200

http_methodstring

The HTTP method used for the request.

Enum:"get""post""put""delete""patch"

Example:"post"

error_typestring or null

The type of error that occurred, if any.

Enum:"request_configuration_error""faraday_error""3rd_party_error""response_mapping_error""token_refresh_error""fin_action_response_formatting_error""fin_action_identity_verification_error""email_verification_error""non_fin_standalone_action_identity_verification_error""request_validation_error"

Example:"3rd_party_error"

error_messagestring or null

A human-readable error message. Any http or https URLs in it are redacted the same way as request_url; the rest of the message is returned as is.

Example:"Connection refused"

execution_time_msinteger or null

The execution time in milliseconds.

Example:245

source_typestring or null

The type of source that triggered this execution.

Enum:"custom_bot""inbound_custom_bot""button_custom_bot""answer""workflow""saved_reply""triggerable_custom_bot""inbox""fin""synthetic_test"

Example:"workflow"

source_idstring or null

The identifier of the source that triggered this execution.

Example:"5001"

conversation_idstring or null

The conversation associated with this execution, if any.

Example:"8001"

created_atstring, (date-time)

The time the execution occurred.

Example:"2026-02-10T18:15:32Z"

request_urlstring or null

The request URL. Query parameters, userinfo, and fragments are redacted. For some hosts that put credentials in the path, the path is removed too. A suffix such as [query params redacted] or [credentials redacted] is appended when anything is redacted, and a URL that cannot be parsed becomes [invalid URL redacted].

Example:"https://api.example.com/webhook"

request_bodystring or null

The request body sent to the external API.

Example:"{\"message\": \"hello\"}"

response_bodystring or null

The response body from the external API.

Example:"{\"status\": \"ok\"}"

raw_response_bodystring or null

The raw (unmapped) response body.

Example:"{\"status\": \"ok\"}"

Response

{
  "type": "data_connector.execution",
  "id": "99001",
  "data_connector_id": "12345",
  "success": true,
  "http_status": 200,
  "http_method": "post",
  "execution_time_ms": 150,
  "source_type": "workflow",
  "source_id": "5001",
  "conversation_id": "8001",
  "created_at": "2026-02-10T18:15:32Z",
  "request_url": "https://api.example.com/webhook",
  "request_body": "{\"channel\": \"#alerts\", \"text\": \"Conversation updated\"}",
  "response_body": "{\"ok\": true}",
  "raw_response_body": "{\"ok\": true}"
}