Overview

The Tags API lets you list all tags configured on your team. Use tag names when filtering conversations by tags in the search endpoints.

Tag constraints

Field	Constraint
Name	Required. Max 255 characters.
Key	Auto-generated from the name (lowercase, alphanumeric). Used as the identifier in the API.
Color	Optional. Hex format, max 7 characters (e.g., `#FF0000`).
Uniqueness	Tag keys are unique per team. Names are case-insensitive — `Support` and `support` resolve to the same tag.

The API lets you manage the tag lifecycle — list, create, and delete tags — and add or remove them from calls.

All available call tags with name and color

Create a new tag from a display name

Delete a tag by its key

Add one or more tags to a call

Remove a tag from a call