Create tag
Tags
Create tag
Creates a new tag on the team. The tag key is auto-generated by slugifying the name.
POST
Create tag
Required scope:
TAGS_WRITEBehavior
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).
id is the generated key — use it to add the tag to calls or to delete it.
Idempotency
This endpoint supports theIdempotency-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
Body
application/json
Response
Tag created