Intercom API (unofficial showcase)
GET/tags

List tags

Lists tags in the workspace. Use this endpoint to retrieve the tags available for labeling contacts, companies, and conversations.

1 parameter
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

2 status codes
200Returns a list of tag objects associated with the workspace.
typestringoptional
The type of the object
Allowed:list
dataarray<Tag>optional
A list of tags objects associated with the workspace .
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 401 is returned when the request is unauthorized. The Intercom-Version header defaults to 2.17 when omitted.