Home
/
REST API Reference
/
Conversations
/
Add tag to a conversation

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.

SecurityHTTP: bearerAuth
Request
path Parameters
conversation_id
required
string

conversation_id

Example: 64619700005694
header Parameters
Intercom-Version
string (intercom_version)
Default: 2.10

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

Enum: "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" "Unstable"
Example: 2.10
Request Body schema: application/json
id
required
string

The unique identifier for the tag which is given by Intercom

admin_id
required
string

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

post
/conversations/{conversation_id}/tags
Request samples
application/json
{
"id": 1405,
"admin_id": 991282417
}
Responses

200

successful

Response Schema: application/json
type
string

value is "tag"

id
string

The id of the tag

name
string

The name of the tag

applied_at
integer <date-time>

The time when the tag was applied to the object

object (Reference)

reference to another object

401

Unauthorized

404

Conversation not found

Response samples
application/json
{
"type": "tag",
"id": "1405",
"name": "Manual tag"
}