WhatsAble
API v1Labels

List labels

gethttps://api.whatsable.app/v1/labels
Build a request to copy

This page never sends a request. Fill in the fields, then copy the request and run it from your server.

Request
curl -X GET 'https://api.whatsable.app/v1/labels'

Authorization

bearerAuth
headerAuthorizationBearer <nfy_live_<32 characters>>

An API key from Settings > API keys, sent as Authorization: Bearer <key>.

Query Parameters

limit?integer

How many items to return, 1 to 100.

Range1 <= value <= 100
Default25
cursor?string

The next_cursor of the previous page. An expired or malformed cursor answers 400 invalid_cursor.

Length1 <= length <= 512

Response Body

A page of labels, newest first.

application/json
  1. response
object*string
data*array<>
has_more*boolean

True when another page follows this one.

next_cursor*|

Pass as cursor to read the next page. Null on the last page. Valid for 24 hours.

Example Request
curl -X GET 'https://api.whatsable.app/v1/labels'
Example Response
{  "object": "list",  "data": [    {      "object": "label",      "id": "cm2v8l1a00001qz8h2b3c4d5e",      "name": "VIP",      "color": "label-2",      "description": "Customers with more than five orders",      "keywords": [        "vip"      ],      "number_ids": [],      "created_at": "2026-09-01T12:00:00Z",      "updated_at": "2026-09-01T12:00:00Z"    }  ],  "has_more": true,  "next_cursor": "string"}