Intercom API (unofficial showcase)
PATCH/data_connectors/{id}

Update a data connector

Updates an existing data connector's configuration. Supply only the fields to change; set state to live or draft to change the connector's state. Updating data_inputs replaces all existing inputs.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters · 15 body fields
idstringrequired
The unique identifier of the data connector to update.
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

The data connector fields to update. All fields are optional; supplying data_inputs replaces the existing inputs.

namestringoptional
The name of the data connector.
descriptionstringoptional
A description of what this data connector does.
statestringoptional
The desired state of the connector.
Allowed:draftlive
http_methodstringoptional
The HTTP method used by the data connector.
Allowed:getpostputdeletepatch
urlstringoptional
The URL of the external API endpoint. Supports template variables like `{{order_id}}`.
bodystringoptional
The request body template. Supports template variables.
direct_fin_usagebooleanoptional
Whether this connector is used directly by Fin.
audiencesarray<string>optional
The audience types this connector targets.
headersarray<object>optional
HTTP headers to include in the request.
data_inputsarray<object>optional
The input parameters accepted by this data connector. Replaces all existing inputs.
customer_authenticationbooleanoptional
Whether OTP authentication is enabled for this connector.
bypass_authenticationbooleanoptional
Whether authentication is bypassed for this connector.
validate_missing_attributesbooleanoptional
Whether to validate missing attributes before execution.
mock_responseobjectoptional
A sample JSON response from the external API. Auto-generates `response_fields` and sets `configuration_response_type` to `mock_response_type`.
token_idsarray<string>optional
IDs of authentication tokens to attach to this data connector. An empty array removes all tokens.

5 status codes
200Returns the updated data connector, including its identifier and configuration.
typestringoptional
The type of object - `data_connector`.
Allowed:data_connector
idstringoptional
The unique identifier for the data connector.
namestringoptional
The name of the data connector.
descriptionstringoptional
A description of what this data connector does.
statestringoptional
The current state of the data connector.
Allowed:draftlive
urlstringoptional
The URL of the external API endpoint. Supports template variables like `{{order_id}}`.
bodystringoptional
The request body template. Supports template variables.
headersarray<object>optional
HTTP headers for the request. Header values are always redacted as `"****"` in responses.
http_methodstringoptional
The HTTP method used by the data connector.
Allowed:getpostputdeletepatch
direct_fin_usagebooleanoptional
Whether this connector is used directly by Fin.
audiencesarray<string>optional
The audience types this connector targets.
execution_typestringoptional
How the connector executes.
Allowed:server_sideclient_side
configuration_response_typestringoptional
The expected response format from the connector.
Allowed:test_response_typemock_response_type
data_transformation_typestringoptional
The type of data transformation applied to the response.
Allowed:full_accessredacted_accesscode_block_transformation
client_function_namestringoptional
The name of the client-side function, if applicable.
client_function_timeout_msintegeroptional
Timeout in milliseconds for the client function, if applicable.
data_inputsarray<object>optional
The input parameters accepted by this data connector.
response_fieldsarray<object>optional
The fields returned in the connector response.
object_mappingsarray<object>optional
Mappings from connector response objects to Intercom objects.
token_idsarray<string>optional
IDs of authentication tokens associated with this connector.
customer_authenticationbooleanoptional
Whether OTP authentication is enabled for this connector.
bypass_authenticationbooleanoptional
Whether authentication is bypassed for this connector.
validate_missing_attributesbooleanoptional
Whether to validate missing attributes before execution.
created_by_admin_idstringoptional
The ID of the admin who created this connector.
updated_by_admin_idstringoptional
The ID of the admin who last updated this connector.
created_atstringoptional
The time the data connector was created.
updated_atstringoptional
The time the data connector was last updated.
execution_results_urlstringoptional
The URL path to fetch execution results for this connector.
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 data connector is not found.

One documented failure

  • data_connector_not_found

    Data connector not found

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
409Returned when the update conflicts with the current state.

One documented failure

  • data_connector_in_use

    Data connector is in use by other resources and cannot be set to draft

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
422Returned when a parameter is invalid.

One documented failure

  • parameter_invalid

    Invalid audiences. Must be a subset of: leads, users, visitors

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, a 404 when the data connector is not found, a 409 when the update conflicts, and a 422 when a parameter is invalid. The id path parameter must identify a data connector; state must be draft or live, and http_method must be get, post, put, delete, or patch.