Skip to main content
POST
Create Label
Required token scopes: Manage labels

Authorizations

Authorization
string
header
required

API token generated in Texter: gear icon → Developers → API Tokens. When creating a token, assign it the scopes required by the endpoints you plan to call - each endpoint lists its required scopes.

Body

application/json
id
string
required

Label ID (1-100 characters)

Required string length: 1 - 100
name
string
required

Label display name (1-100 characters)

Required string length: 1 - 100
color
string

Label color in full hex format (e.g. #a83236)

Response

The newly created label. Field-by-field reference: The Label object

A label defined in Texter

id
string

Unique label ID (1-100 characters)

Example:

"hot_lead"

name
string

Display name (1-100 characters)

Example:

"HOT LEAD"

color
string

Full hex color (#RRGGBB). Defaults to #555555 when omitted at creation

Example:

"#2CCCE4"

system
boolean

Present and true on system labels (defined by Texter, e.g. failed-message). System labels cannot be created or deleted via the API; only their name and color can be updated