Add tag to a conversation

Request

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

Security

bearerAuth

Path

conversation_idstringrequired

conversation_id

Example:64619700005694

Intercom-Versionstring(intercom_version)

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

Default:"2.11"

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"

Example:2.11

Bodyapplication/json

idstringrequired

The unique identifier for the tag which is given by Intercom

Example:"7522907"

admin_idstringrequired

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

Example:"780"

curl -i -X POST \
  https://api.intercom.io/conversations/64619700005694/tags \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Intercom-Version: 2.11' \
  -d '{
    "id": 99,
    "admin_id": 991267526
  }'

Responses

successful

Bodyapplication/json

typestringrequired

value is "tag"

Example:"tag"

idstringrequired

The id of the tag

Example:"123456"

namestringrequired

The name of the tag

Example:"Test tag"

applied_atinteger or null, (date-time)required

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:1663597223

applied_byobject or null(Reference)required

The admin who applied the tag. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket.

Response

{
  "type": "tag",
  "id": "99",
  "name": "Manual tag",
  "applied_at": 1663597223,
  "applied_by": {
    "type": "admin",
    "id": "456"
  }
}