younifyd
Menu

Attach Tag To Article

Add a tag to an article

POST/articles/{article_id}/tags

Use it in a workflow

  1. Add a step and choose the Intercom connector.
  2. Pick the Attach Tag To Article action (under Articles).
  3. Fill in the fields below, then reference the result from later steps as {{attachTagToArticle.response.data}}.

Request

Path parameters

article_idintegerrequired

The unique identifier for the article 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 of the tag to apply, as given by Intercom.

admin_idstring

Optional id of the teammate to attribute the tagging to. Defaults to the authenticating teammate. Does not affect authorization.

json
{
  "id": "7522907",
  "admin_id": "1234"
}

Response

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