Skip to main content
POST
/
labels
Create Label
curl --request POST \
  --url https://api.attention.tech/v2/labels \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
    }
  ]
}
'
{
  "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"
  }
}

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:
{
  "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": [
    {
      "value": "high-intent",
      "description": "Prospect has explicit buying signals"
    }
  ],
  "organizationUUID": "16b78cec-82ef-46d2-8213-5d3bb7d2571c",
  "createdAt": "2026-04-16T18:00:00Z"
}