Intercom API (unofficial showcase)
GET/data_connectors/{id}/versions

List versions of a data connector

Lists a data connector's version history, with the newest version first. Each entry is a configuration snapshot with its current status and an optional note; connectors that have never been published return an empty data list. Use starting_after to paginate, and provide one of the required version-reading OAuth scopes.

4 parameters
idstringrequired
The unique identifier of the data connector whose versions to list.
per_pageintegeroptional
Number of results per page, from 1 to 50. Defaults to 20 when omitted; values outside the range are clamped, and non-integer values use the default.
Default:20
starting_afterstringoptional
Pagination cursor from `pages.next.starting_after` in the previous response.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

4 status codes
200Returns a paginated list of data connector version snapshots, newest first, with pagination information; `pages.next` is omitted on the last page.
typestringoptional
The type of object - `list`.
Allowed:list
dataarray<DataConnectorVersion>optional
An array of data connector version objects.
pagesobjectoptional
Pagination information. `next` is omitted on the last page.
400Returned when a parameter 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.

2 documented failures

  • unauthorized

    Access Token Invalid

  • token_unauthorized

    Not authorized to access resource

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the data connector is not found.

One documented failure

  • data_connector_not_found

    Data connector not found

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 for an invalid parameter, a 401 when the request is unauthorized, and a 404 when the data connector is not found. Use the read_data_connector_versions or read_write_data_connector_versions OAuth scope; per_page defaults to 20 and is clamped to the range 1–50.