Create a WhatsApp group on one of your WHATSAPP_OFFICIAL channels.
Creation is asynchronous. This call returns a requestId immediately; WhatsApp then creates the group and notifies us, typically within a few seconds. To obtain the group's chatId:
- Poll
GET /api/wp-crm/groups/:orgId/creation-status/:requestIduntilstatusiscreated, or - Subscribe to the
group.createdwebhook — its payload carries the samerequest_idplus thechat_id.
The returned chatId is a normal chat id — use it to send messages (POST /api/wp-crm/messaging/send-message), assign users/teams (POST /api/wp-crm/chat-assignments/...), and read the conversation (GET /api/wp-crm/chats/...).
A new group contains only your business number. Add members with the participants endpoint or share the invite link.
Security:
- The
organisationIdin the URL must match the organisation your JWT was issued for — requests for a different organisation fail with 401. - Requires
CRM_ADMIN,ACCOUNT_OWNER, orCRM_BOTrole; other roles receive 403. - Groups are only supported on
WHATSAPP_OFFICIALchannels whose number is an Official Business Account (OBA); ineligible numbers receive 422.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400Bad request — invalid body
401Unauthorized
403Forbidden — role not permitted
404Channel not found in your organisation
422The channel number is not eligible for groups (requires an Official Business Account)
429Too many requests
500Internal server error
