Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-1398228598.3 KB
Label

Create Label

Creates a new label in the caller's organization. The label name must be unique within the organization; attempting to create a duplicate returns 409. On a network retry after a successful first request, clients may observe a 409 and should fetch the label by name to confirm creation.

post/labels

Request body

namestring required

Human-readable label name. Trimmed before validation. Must be unique within the organization.

descriptionstring

Optional description of the label. 0 to 2000 characters.

aiFlowboolean

Whether this label participates in the AI flow (auto-classification during conversation post-processing). Defaults to false.

allTeamsboolean

Whether this label applies to all teams in the organization. Defaults to false.

Example request

{
  "name": "Buying Signal",
  "description": "Conversations where the prospect expresses a buying signal.",
  "aiFlow": true,
  "allTeams": false,
  "options": [
    {
      "value": "high-intent",
      "description": "Prospect has explicit buying signals"
    }
  ]
}

Response

Label successfully created

Example response

{
  "data": {
    "uuid": "fe515723-fe2e-4959-a5fa-c4d3937fe7e4",
    "name": "Buying Signal",
    "description": "Conversations where the prospect expresses a buying signal.",
    "aiFlow": true,
    "allTeams": false,
    "isDefaultTemplate": false,
    "options": [],
    "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
    "createdAt": "2026-04-16T18:00:00Z"
  }
}