younifyd
Menu

Detach Tag From Conversation

Remove tag from a conversation

DELETE/conversations/{conversation_id}/tags/{tag_id}

Use it in a workflow

  1. Add a step and choose the Intercom connector.
  2. Pick the Detach Tag From Conversation action (under Tags).
  3. Fill in the fields below, then reference the result from later steps as {{detachTagFromConversation.response.data}}.

Request

Path parameters

conversation_idstringrequired

conversation_id

tag_idstringrequired

tag_id

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.

admin_idstringrequired

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

json
{
  "admin_id": "123"
}

Response

Returns 200 with an object. Read it in later steps with {{detachTagFromConversation.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.