v51

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

Add tag to a conversation

You can tag a specific conversation. This will return a tag object for the tag that was added to the conversation.

post/conversations/{conversation_id}/tags

Path parameters

conversation_idstring required

conversation_id

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

Request body

idstring required

The unique identifier for the tag which is given by Intercom

admin_idstring required

The unique identifier for the admin which is given by Intercom.

Example request

{
  "id": "7522907",
  "admin_id": "780"
}

Response

successful

typestring

value is "tag"

idstring

The id of the tag

namestring

The name of the tag

applied_atinteger nullable

The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket.

Example response

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