Intercom API (unofficial showcase)
GET/data_connectors/{data_connector_id}/execution_results/{id}

Retrieve a data connector execution result

Retrieves the details of a specific execution result for a data connector. The response always includes request and response bodies, as well as a sanitized request URL. Use the result to inspect the external API call and its outcome.

3 parameters
data_connector_idstringrequired
The unique identifier of the data connector that produced the execution result.
idstringrequired
The unique identifier of the execution result to retrieve.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

3 status codes
200Returns the execution result, including success status, external HTTP status and method, error details when applicable, execution time, sanitized request URL, and request and response bodies.
typestringoptional
The type of object - `data_connector.execution`.
Allowed:data_connector.execution
idstringoptional
The unique identifier for the execution result.
data_connector_idstringoptional
The unique identifier of the data connector that produced this result.
successbooleanoptional
Whether the execution was successful.
http_statusintegeroptional
The HTTP status code returned by the external API.
http_methodstringoptional
The HTTP method used for the request.
Allowed:getpostputdeletepatch
error_typestringoptional
The type of error that occurred, if any.
Allowed:request_configuration_errorfaraday_error3rd_party_errorresponse_mapping_errortoken_refresh_errorfin_action_response_formatting_errorfin_action_identity_verification_erroremail_verification_errornon_fin_standalone_action_identity_verification_errorrequest_validation_errorclient_side_action_error
error_messagestringoptional
A human-readable error message. Query parameters, userinfo, and fragments in URLs are redacted.
execution_time_msintegeroptional
The execution time in milliseconds.
source_typestringoptional
The type of source that triggered this execution.
Allowed:custom_botinbound_custom_botbutton_custom_botanswerworkflowsaved_replytriggerable_custom_botinboxfin
source_idstringoptional
The identifier of the source that triggered this execution.
conversation_idstringoptional
The conversation associated with this execution, if any.
created_atstringoptional
The time the execution occurred.
request_urlstringoptional
The request URL. Query parameters, userinfo, and fragments are redacted.
request_bodystringoptional
The request body sent to the external API.
response_bodystringoptional
The response body from the external API.
raw_response_bodystringoptional
The raw (unmapped) response body.
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the execution result is not found.

2 documented failures

  • data_connector_not_found

    Data connector not found

  • execution_result_not_found

    Execution result not found

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when the request is unauthorized, and a 404 when the execution result is not found. The data_connector_id path parameter must identify the data connector, and the id path parameter must identify its execution result.