Skip to content
Home/
/Data Connectors

List all data connectors

Request

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.

Security
bearerAuth
Query
per_pageinteger, [ 1 .. 50 ]

The number of results to return per page. Defaults to 20, minimum 1, maximum 50.

Default:20
starting_afterstring

The cursor value from pages.next.starting_after in a previous response. Used to paginate through results.

Headers
Intercom-Versionstring(intercom_version)

Intercom API version.
By default, it's equal to the version set in the app package.

Default:"Preview"
Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"
Example:Preview
/**
 * Requires libcurl
 */

$query = array(
  "per_page" => "20",
  "starting_after" => "string"
);

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <YOUR_TOKEN_HERE>",
    "Intercom-Version: Preview"
  ],
  CURLOPT_URL => "https://api.intercom.io/data_connectors?" . http_build_query($query),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$error = curl_error($curl);

curl_close($curl);

if ($error) {
  echo "cURL Error #:" . $error;
} else {
  echo $response;
}

Responses

successful

Bodyapplication/json
typestring

The type of object - list.

Value:"list"
Example:"list"
dataArray of objects(Data Connector)

An array of data connector objects.

pagesobject

Pagination information.

Response
{
  "type": "list",
  "data": [
    { … }
  ],
  "pages": {
    "type": "pages",
    "per_page": 20,
    "next": { … }
  }
}