GET/data_connectors

List data connectors

Lists the workspace's data connectors, ordered from most recently updated to least recently updated. Use per_page to set the page size and starting_after from pages.next.starting_after to continue through the results.

3 parameters
per_pageintegeroptional
The number of results per page. Must be between 1 and 50. Defaults to 20 when omitted.
Default:20
starting_afterstringoptional
The cursor from `pages.next.starting_after` in a previous response, used to fetch the next page.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted; use a supported version.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

3 status codes
200Returns a paginated list of data connector objects and pagination information.
typestringoptional
The type of object - `list`.
Allowed:list
dataarray<DataConnector>optional
An array of data connector objects.
pagesobjectoptional
Pagination information.
400Returned when a query value is invalid.

One documented failure

  • client_error

    Invalid starting_after param. Please try again using a starting_after value from a paginated response

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
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

Error handling

A 400 is returned when a query value is invalid, and a 401 is returned when the request is unauthorized. per_page must be between 1 and 50; it defaults to 20 when omitted.