Attach Tag To Contact

Add tag to a contact

POST/contacts/{contact_id}/tags

Use it in a workflow

Add a step and choose the Intercom connector.
Pick the Attach Tag To Contact action (under Tags).
Fill in the fields below, then reference the result from later steps as {{attachTagToContact.response.data}}.

Request

Path parameters

contact_idstringrequired

The unique identifier for the contact which is given by Intercom

Headers

Intercom-Versionstring

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

One of1.01.11.21.31.42.02.12.22.32.42.52.62.72.82.92.102.112.122.132.142.152.16Default "2.16"

Request body

Enter the body as JSON in the step's Body field.

idstringrequired

The unique identifier for the tag which is given by Intercom

json

{
  "id": "7522907"
}

Response

Returns 200 with an object. Read it in later steps with {{attachTagToContact.response.data.<field>}}.

typestring

value is "tag"

idstring

The id of the tag

namestring

The name of the tag

applied_atinteger (date-time)

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.

applied_byobject

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.

json

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

Need more? See the Intercom guide for connection setup and behaviour shared by every action.

Was this page helpful?