Skip to main content
Create a new WhatsApp group with specified participants.
You must include at least one participant to create a group. You will automatically be added as the group admin.

Request

X-Device-Id
string
Device identifier for multi-device support. Required when multiple devices are registered. If only one device is registered, it will be used as the default.
title
string
required
The name of the group to createExample: Example Group Title
participants
array
required
Array of phone numbers (without country code suffix) to add as group membersExample: ["6819241294719274", "6829241294719274", "6839241294719274"]

Response

code
string
Response code (e.g., SUCCESS)
message
string
Response message describing the resultExample: Success get list groups
results
object
group_id
string
The unique identifier of the newly created groupExample: [email protected]
curl -X POST \
  'https://your-api-domain.com/group' \
  -H 'Content-Type: application/json' \
  -H 'X-Device-Id: my-device' \
  -u 'username:password' \
  -d '{
    "title": "Example Group Title",
    "participants": [
      "6819241294719274",
      "6829241294719274",
      "6839241294719274"
    ]
  }'
{
  "code": "SUCCESS",
  "message": "Success get list groups",
  "results": {
    "group_id": "[email protected]"
  }
}

Build docs developers (and LLMs) love