Create or update a tag

Example Request & Response

$ curl https://api.intercom.io/tags \
-X POST \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' -d'
{
  "name": "Independent"
}'
HTTP/1.1 200 Ok

{
  "type": "tag",
  "name": "Independent",
  "id": "17513"
}
intercom.tags.tag(name: 'Independent', users: [{ id: "42ea2f1b93891f6a99000427" }])
<?php
$intercom->tags->tag(["name" => "php-tag"]);
?>
Tag t = new Tag().setName("Independent");
t = Tag.create(t);

You can create or update a tag.

Request Body Parameters

AttributeRequiredDescription
nameYesThe name of the tag, which will be created if not found, or the new name for the tag if this is an update request. Names are case insensitive.
idOnly for updateThe id of tag to updates.

Response

This will return a Tag Model of the tag you just created or updated.