List All Labels

curl -g "https://YOUR_PROJECT.texterchat.com/server/api/v2/labels" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "total": 3,
  "labels": [
    {
      "id": "hp-high-priority",
      "name": "High Priority",
      "color": "#F47373"
    },
    {
      "id": "hot_lead",
      "name": "HOT LEAD",
      "color": "#2CCCE4"
    },
    {
      "id": "VIP",
      "name": "VIP",
      "color": "#dce775"
    }
  ]
}

{
  "error": "skip: Invalid value. Should be a positive integer less than 100000"
}

GET

labels

curl -g "https://YOUR_PROJECT.texterchat.com/server/api/v2/labels" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "total": 3,
  "labels": [
    {
      "id": "hp-high-priority",
      "name": "High Priority",
      "color": "#F47373"
    },
    {
      "id": "hot_lead",
      "name": "HOT LEAD",
      "color": "#2CCCE4"
    },
    {
      "id": "VIP",
      "name": "VIP",
      "color": "#dce775"
    }
  ]
}

{
  "error": "skip: Invalid value. Should be a positive integer less than 100000"
}

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.

Query Parameters

limit

string

The maximum number of results to return (1-10000)

skip

string

The number of results to skip before starting to return records (0-100000)

Response

The labels and total count. Field-by-field reference: The Label object

total

number

Total number of labels

labels

object[]

Show child attributes

Getting Started

Endpoints

Webhooks

Objects

Authorizations

Query Parameters

Response