Manage Labels via WhatChimp API

List and create subscriber labels programmatically

Updated 10 February 2026

Labels help you organize and categorize your subscribers. Use these endpoints to list existing labels and create new ones programmatically.

Before you begin: Make sure you have your WhatChimp API credentials ready.

Video: https://www.youtube.com/watch?v=pYpWuoHSZlk

Endpoints

1. Label List

GET/POST /api/v1/whatsapp/label/list

Retrieve all labels associated with your phone number.

2. Label Create

GET/POST /api/v1/whatsapp/label/create

Create a new label for organizing subscribers.

Parameters

Label List Parameters

Parameter	Type	Required	Description
`apiToken`	String	Yes	Your WhatChimp API token
`phone_number_id`	String	Yes	Your WhatsApp Business phone number ID

Label Create Parameters

Parameter	Type	Required	Description
`apiToken`	String	Yes	Your WhatChimp API token
`phone_number_id`	String	Yes	Your WhatsApp Business phone number ID
`label_name`	String	Yes	Name of the label to create

Request Examples

Label List - GET Request

curl -X GET "https://app.whatchimp.com/api/v1/whatsapp/label/list?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID"

Label List - POST Request (cURL)

curl -X POST https://app.whatchimp.com/api/v1/whatsapp/label/list \
  -H "Content-Type: application/json" \
  -d '{
    "apiToken": "API-KEY",
    "phone_number_id": "PHONE-NUMBER-ID"
  }'

Label Create - GET Request

curl -X GET "https://app.whatchimp.com/api/v1/whatsapp/label/create?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&label_name=VIP Customers"

Label Create - POST Request (cURL)

curl -X POST https://app.whatchimp.com/api/v1/whatsapp/label/create \
  -H "Content-Type: application/json" \
  -d '{
    "apiToken": "API-KEY",
    "phone_number_id": "PHONE-NUMBER-ID",
    "label_name": "VIP Customers"
  }'

Response

Label List Response

{
  "status": "1",
  "message": [
    {
      "id": 1,
      "label_name": "Your label name",
      "status": "1"
    }
  ]
}

Label Create Response

{
  "status": "1",
  "message": "Label has been created successfully."
}

Use Cases

Auto-create labels from external systems (CRM tags)
Sync label categories across platforms
Build custom subscriber segmentation workflows
Organize subscribers based on user behavior or attributes