Delete a tag

Deletes a tag definition. The delete is permanent: the tag no longer appears in GET /tags and GET /tags/{id} returns 404. The tag's associations to contacts are not deleted with it: they no longer appear under GET /contacts/{id}/contactTags, but GET /contactTags still lists them (for example with filters[tagid]) and counts them in meta.total, and each one can still be fetched with GET /contactTags/{id} and removed with DELETE /contactTags/{id}. Links from templates to the tag are removed. Automations and segments that reference the tag are not changed. To take a tag off a single contact without deleting the tag, use DELETE /contacts/{id}/tags/{tagId} instead. Returns 200 with an empty object. Requires the tag management permission.

❗️

This will remove the tag from all Contacts

This call will remove the targeted tag from all Contacts that have it.

To remove a tag for an individual contact, but not delete the tag itself:
Retrieve the "association id" with a GET call to /api/3/contacts/:contactId/contactTags,
Then delete that associate between tag and contact, here: https://developers.activecampaign.com/reference/remove-a-contacts-tag

Path Params
int32
required

ID of the tag to remove

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Choose an example:
application/json