v52

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-06150230856.2 KB

List all tags

You can fetch a list of all tags for a given workspace.

get/tags

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

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

Example:2.14

Response

successful

type'list'

The type of the object

Example response

{
  "type": "list",
  "data": [
    {
      "type": "tag",
      "id": "123456",
      "name": "Test tag",
      "applied_at": 1663597223,
      "applied_by": {
        "type": "contact",
        "id": "1a2b3c"
      }
    }
  ]
}