Removes a tag from a contact by the contactTag association id (returned by GET /contactTags, POST /contactTags, or POST /contacts/{id}/tags). This is not the tag id. The tag definition itself is not deleted. Returns 404 if the association does not exist. To remove a tag by contact id and tag id or name instead, use DELETE /contacts/{id}/tags/{tagId} or DELETE /contacts/{id}/tags with the tag query parameter. Removing the tag starts the automations that start when this tag is removed, and sends the contact_tag_removed and contact updated webhooks. Requires the contact edit permission; users outside the main user group can only remove tags from contacts on their lists.
This will not delete the tag for other contactsThis call will only remove the tag on the individual contact.
For example, "John Doe", a contact with and id of
6has the tag "foo," and that tag has the id of11.When the tag id
foois placed on John Doe's contact, an "association id" is created, id22.A DELETE call to
/contactTags/22will delete the association of "John Doe" and the "foo" tag. It will not delete the "foo" tag for other Contacts, only for "John Doe," because the association between the tag and the each other Contact will have a different association id.
Retrieving a contact's tag id'sThe correct tag
association idnecessary for this call, and can be retrieved with a GET request to/api/3/contacts/:contactId/contactTags