# 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.
 - [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
