Skip to main content
POST
Create tag
Required scope: TAGS_WRITE

Behavior

Pass a display name — the tag key (its identifier in the rest of the API) is generated automatically by slugifying the name (lowercase, alphanumeric). For example "Interested" becomes the key interested.
  • Names are case-insensitive. Creating Support when support already exists returns a 409 with code TAG_ALREADY_EXISTS.
  • Names that describe a call outcome (e.g. voicemail, missed call, busy) are reserved and rejected with a 400 and code TAG_NAME_IS_CALL_OUTCOME.
  • color is an optional hex string (max 7 characters, e.g. #FF0000).
The created tag’s id is the generated key — use it to add the tag to calls or to delete it.

Idempotency

This endpoint supports the Idempotency-Key header. If a request succeeds and you retry with the same key, the stored response is returned without re-executing the operation. See Idempotency.

Authorizations

Authorization
string
header
required

Body

application/json
name
string
required

Tag display name. The key (identifier) is derived from it.

Maximum string length: 255
Example:

"Interested"

color
string | null

Optional hex color (e.g. #FF0000).

Maximum string length: 7
Example:

"#123456"

Response

Tag created

data
object