List all auth tokens

Request

Returns a paginated list of the workspace's stored third-party credentials. Use this to discover the id of a credential you want a data connector to authenticate with — that id is not otherwise available over REST. Only metadata is returned; credential values are never exposed. The list is not exhaustive: credentials a teammate created are listed, as are those created by some Intercom integrations, but credentials installed by an app package, those created by most other integrations, and those minted for an individual teammate's MCP access are not.

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.

Intercom-Versionstring(intercom_version_preview)

Preview Intercom API version. Used for closed beta endpoints or other features under managed availability.

Default:"Preview"

Value:"Preview"

Example:Preview

curl -i -X GET \
  'https://api.intercom.io/auth_tokens?per_page=20&starting_after=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

Responses

successful

Bodyapplication/json

typestring

The type of object - list.

Value:"list"

Example:"list"

dataArray of objects(Auth Token)

An array of auth token objects.

pagesobject

Pagination information.

Response

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