Skip to main content
GET
Get Label Data
Required token scopes: none - any valid API token works

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.

Path Parameters

labelId
string
required

The unique identifier of the label. You can retrieve all existing labels using the List All Labels endpoint

Response

The label object. 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