2ChatCo 2Chat — WhatsApp Groups
Create and manage WhatsApp groups via the 2Chat API.
Authentication
All requests require the header:
X-User-API-Key: <api_key>
API keys are generated at app.2chat.io/developers. Base URL: https://api.p.2chat.io/open
List groups
GET /whatsapp/groups/{phone_number}
Returns array of groups with uuid, wa_group_name, size, is_muted, is_read_only, channel_is_owner, profile_pic_url, and owner_contact.
Create group
POST /whatsapp/group/create
{
"from_number": "+595981048477",
"group": {
"name": "My cool WhatsApp group",
"description": "Group description",
"participants": ["+17137157533", "+18647351567"]
}
}
Max 10 initial participants. Response includes uuid, accepted_numbers, and unaccepted_numbers. Use Add Participant for additional members.
WhatsApp has a non-published soft limit on group creation rate.
Get group details and participants
GET /whatsapp/group/{group_uuid}
Returns group metadata and full participant list. Each participant includes wa_is_admin, wa_is_super_admin, wa_pushname, phone_number, device, and linked contact.
Add participants
POST /whatsapp/group/{group_uuid}/add-participant
{
"from_number": "+12123334444",
"participants": ["+447700176576", "+17137157533"]
}
Max 10 per request. Response shows per-number status and unaccepted_numbers.
Remove participants
POST /whatsapp/group/{group_uuid}/remove-participant
{
"from_number": "+12123334444",
"participants": ["+447700176576", "+17137157533"]
}
Max 10 per request. Returns accepted_numbers and unaccepted_numbers.
Promote to admin
POST /whatsapp/group/{group_uuid}/promote-participant
{
"from_number": "+12123334444",
"participants": ["+447700176576"]
}
Max 10 per request. Changes may take a few minutes to reflect.
Demote from admin
POST /whatsapp/group/{group_uuid}/demote-participant
{
"from_number": "+12123334444",
"participants": ["+447700176576"]
}
Max 10 per request.
Set group description
POST /whatsapp/group/{group_uuid}/set-description
{
"from_number": "+12123334444",
"description": "New group description"
}
Set group picture
POST /whatsapp/group/{group_uuid}/set-picture
{
"from_number": "+12123334444",
"url": "https://example.com/group-photo.jpg"
}
Image URL must be publicly accessible.