API ReferenceBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

Untag companies

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",
  "companies": [
    {
      "id" : "53427b7ecce5722303000003",
      "untag": true
    }
  ]
}
HTTP/1.1 200 Ok

{
  "type": "tag",
  "name": "Follow Up",
  "id": "17513"
}

You can untag a single or a list of companies.

Request Body Parameters

ParametersTypeRequiredDescription
nameStringYesThe name of the tag which will be untagged from the.
companiesObjectYesAn array of objects with the unique id or company_id of the company to be untagged, and the untag boolean set to true.

Response

This will return a Tag model for the tag that was unapplied to the given company.