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

Delete a data connector

Deletes an existing data connector. Use this operation only when the connector is in draft state and is not used by any workflows or AI agents. A successful response confirms whether the connector was deleted.

2 parameters
idstringrequired
The unique identifier of the data connector to delete.
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

4 status codes
200Returns the deleted data connector's identifier, object type, and a `deleted` value indicating whether deletion succeeded.
idstringoptional
The unique identifier for the data connector.
objectstringoptional
The type of object which was deleted.
Allowed:data_connector
deletedbooleanoptional
Whether the data connector was deleted successfully.
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 connector is not in `draft` state or is in use by a workflow or AI agent.

2 documented failures

  • data_connector_in_use

    Data connector is in use by other resources and cannot be deleted

  • conflict

    Data connector must be in draft state to be deleted

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, and a 409 when the connector cannot be deleted because it is not in draft state or is in use. The id path parameter must identify the data connector to delete.