Skip to content
Home/
/Tags

Add a tag to an article

Request

Apply an existing tag to an article. Returns the tag that was applied.

The tag must already exist in the workspace (create tags with the Tags API), and the authenticating teammate must have the manage_knowledge_base_content permission.

Requires the read_write_articles_scope OAuth scope. Set Intercom-Version: Preview.

Security
bearerAuth
Path
article_idintegerrequired

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

Example:123
Headers
Intercom-Versionstring(intercom_version_preview)

Preview Intercom API version. Used for closed beta endpoints or other features under managed availability.

Default:"preview"
Value:"preview"
Example:preview
Bodyapplication/json
idstringrequired

The unique identifier of the tag to apply, as given by Intercom.

Example:"7522907"
admin_idstring or null

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

Example:"1234"
curl -i -X POST \
  https://api.intercom.io/articles/123/tags \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Intercom-Version: preview' \
  -d '{
    "id": "7522907"
  }'

Responses

Tag applied

Bodyapplication/json
typestring

value is "tag"

Example:"tag"
idstring

The id of the tag

Example:"123456"
namestring

The name of the tag

Example:"Test tag"
applied_atinteger or null, (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, ticket, article, internal article, or content snippet.

Example:1663597223
applied_byobject or null(Reference)

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

Response
{
  "type": "tag",
  "id": "7522907",
  "name": "Independent",
  "applied_at": 1663597223,
  "applied_by": {
    "type": "admin",
    "id": "1234"
  }
}