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
Supportwhensupportalready exists returns a409with codeTAG_ALREADY_EXISTS. - Names that describe a call outcome (e.g.
voicemail,missed call,busy) are reserved and rejected with a400and codeTAG_NAME_IS_CALL_OUTCOME. coloris 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.