# Data Connectors

Everything about your Data Connectors

 - [GET /data_connectors](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/listdataconnectors.md): Returns a paginated list of all data connectors for the workspace, ordered by most recently updated first. Data connectors allow workflows and AI agents to make HTTP requests to external APIs.
 - [POST /data_connectors](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/createdataconnector.md): Create a new data connector. The connector is created in `draft` state. Configure its URL, headers, data inputs, and other settings, then set it to `live` when ready.
 - [GET /data_connectors/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/retrievedataconnector.md): You can retrieve the full detail of a single data connector by its ID. The response includes configuration, data inputs, response fields, and object mappings.
 - [DELETE /data_connectors/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/deletedataconnector.md): Delete an existing data connector. The connector must be in `draft` state and must not be in use by any workflows or AI agents.
 - [PATCH /data_connectors/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/updatedataconnector.md): Update an existing data connector. Only provided fields are changed. Set `state` to `live` or `draft` to change the connector's state.
 - [GET /data_connectors/{data_connector_id}/execution_results](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/listdataconnectorexecutionresults.md): Retrieve paginated execution logs for a specific data connector. Results from the last hour are returned by default. Use `start_ts` and `end_ts` to customize the time range. Request/response bodies ar
 - [GET /data_connectors/{data_connector_id}/execution_results/{id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/showdataconnectorexecutionresult.md): Retrieve details for a specific data connector execution result. Always includes request/response bodies and the sanitised request URL.
 - [GET /data_connectors/{id}/versions](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/listdataconnectorversions.md): Retrieve the version history of a data connector, newest first. Each entry is a point-in-time snapshot of the connector's configuration, with the status it has today and an optional note. Results are
 - [GET /data_connectors/{id}/versions/{version_id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/retrievedataconnectorversion.md): Retrieve a single version of a data connector, including the connector configuration as it was at that version. Requires the `read_data_connector_versions` or `read_write_data_connector_versions` OAut
 - [PATCH /data_connectors/{id}/versions/{version_id}](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/updatedataconnectorversion.md): Update the note on a data connector version. The note is the only field that can be changed. This does not publish the version or roll the connector back to it. Send an empty string to clear the note.
 - [Data Connector](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/data_connector.md): Schema: #/components/schemas/data_connector
 - [Data Connector (Detail)](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/data_connector_detail.md): Schema: #/components/schemas/data_connector_detail
 - [Data Connector Execution Result](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/data_connector_execution_result.md): Schema: #/components/schemas/data_connector_execution_result
 - [Data Connector Version](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/data-connectors/data_connector_version.md): Schema: #/components/schemas/data_connector_version