Skip to main content
POST
Create Label

Authorizations

Authorization
string
header
required

Body

Details of the label to create.

Payload for creating a new label in the authenticated organization. The organization UUID is derived from the API key and must not be supplied in the body.

name
string
required

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

Required string length: 1 - 128
Example:

"Buying Signal"

description
string

Optional description of the label. 0 to 2000 characters.

Maximum string length: 2000
Example:

"Conversations where the prospect expresses a buying signal."

aiFlow
boolean

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

Example:

true

allTeams
boolean

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

Example:

false

options
object[]

Optional set of selectable values when the label is a multi-value enum. Omit or send an empty array for binary labels.

Response

Label successfully created

Single-resource response envelope for label endpoints.

data
object

A label (label category) used to classify conversations and drive AI flows, scorecard criteria, and intelligence-item-collection criteria. Labels are scoped to a single organization.

Example: