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.
Endpoints
List tags
All available call tags with name and color
Create tag
Create a new tag from a display name
Delete tag
Delete a tag by its key
Add tags
Add one or more tags to a call
Remove tag
Remove a tag from a call