Create a label
Adds a label teammates can put on conversations. With applies_when, the AI agent adds it to new conversations that match.
POST
/v1/labels Bearer token scope
settings:write Body
required application/json
name string · min length: 1· max length: 60 Unique in the workspace, whatever its case. Needed to add a label.
color string · enum Default slate.
values
slatesandemberroseglacierfern
applies_when string · max length: 500 When the label applies, in plain words. The AI agent adds it to new conversations that match. Empty: it never does.