GET all labels

GET

https://wawp.net/wp-json/awp/v1/labels

Retrieves a list of all labels currently defined in the connected WhatsApp Business account. Labels are used to organize chats and messages (e.g., "New Customer", "Order Complete").

Developer Tips:

Business Accounts Only: Labels are a feature specific to the WhatsApp Business App and WhatsApp Business API. This endpoint may return an empty list or an error if used with a standard personal WhatsApp account.

Color Hex: The response usually includes both a predefined WhatsApp color ID and the approximate HEX code for that color.

Request

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://wawp.net/wp-json/awp/v1/labels?instance_id=YOUR_INSTANCE&access_token=YOUR_TOKEN'

Responses

🟢200Success

application/json

Body

Example

[
  {
    "id": "1",
    "name": "Unread",
    "color": 0,
    "colorHex": "#ff9485"
  },
  {
    "id": "2",
    "name": "Favorites",
    "color": 0,
    "colorHex": "#ff9485"
  },
  {
    "id": "3",
    "name": "Groups",
    "color": 0,
    "colorHex": "#ff9485"
  },
  {
    "id": "4",
    "name": "Communities",
    "color": 0,
    "colorHex": "#ff9485"
  }
]

🟠404invalid_instance

Modified at 2026-01-03 02:27:12

Labels API

Create label