# Data Connectors

Everything about your Data Connectors

## List all 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.

## Create a data connector

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

## Retrieve a data connector

 - [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 a data connector

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

## Update a data connector

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

## List execution results for a data connector

 - [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 and request URL are excluded by default.
Use include_bodies=true to include bodies.
Use include_request_url=true to include the sanitised request URL.

## Retrieve an execution result

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