Groups
Retrieve your contact groups. Groups allow you to organize contacts into segments for targeted messaging and campaign management.
List Groups
GET
/api/wpbox/getGroups
Returns all contact groups in your account along with the number of contacts in each group.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| token Required | string | Your API authentication token. Found in your dashboard under Settings > API. |
Example Request
cURL
curl -G "https://whatsbizapi.com/api/wpbox/getGroups?token=your-api-token"
Example Response
Response — 200 OK
[
{
"id": 1,
"name": "VIP Customers",
"contacts_count": 156
},
{
"id": 2,
"name": "Newsletter Subscribers",
"contacts_count": 2340
},
{
"id": 3,
"name": "Order Follow-ups",
"contacts_count": 89
}
]
Response Fields
| Field | Type | Description |
|---|---|---|
id |
integer | Unique identifier for the group. |
name |
string | Display name of the contact group. |
contacts_count |
integer | Total number of contacts currently assigned to this group. |
Tip: Use group IDs when sending campaigns via the Send Campaign endpoint to target specific segments of your audience.