Skip to main content
POST
Create group (Enhanced)
Creates a group with a name and a list of participants (numbers in international format). Supports advanced settings at creation time:
  • admin_only_messages — only admins can send messages.
  • admin_approval — joining requires admin approval.
  • description, picture — group metadata.
  • disappearing_messages — disappearing messages (24h, 7d, 90d).
For large groups, use async to create the group asynchronously and avoid timeouts. Participants are added in the background.

Communities

Create a community

Send is_parent: true. WhatsApp creates the community together with its announcement group and a General subgroup.
  • The community starts with only you as admin. participants is still required, but it is ignored in this case.
  • The response carries the community JID. The JIDs of the announcement group and of General show up in GET /api/v1/groups/list; in each group’s /info, is_community, linked_parent_jid and is_announcement_group tell its role.
  • Members join through the announcement group: use add on /groups/{groupId}/participants with its JID. An add on the community JID is redirected to the announcement group.
  • Admins are set on the community JID, with promote/demote. The person must already be a member.

Create a group inside the community

Send parent_jid with the community JID. The group is created already linked to it, with the given participants.
parent_jid can’t be used together with is_parent. To move a group that already exists into the community, use POST /api/v1/groups/{groupId}/link with the community JID in parent_jid. The session must be a community admin.
Linking a group seconds after creating it usually fails. To get a new group inside the community, create it with parent_jid.

Authorizations

Authorization
string
header
required

API Key for authentication. Format: <API_KEY>

Body

sessionId
string
required
Minimum string length: 1
name
string
required
Minimum string length: 1
participants
string[]
required
Minimum array length: 1
async
is_parent
boolean
parent_jid
string
Minimum string length: 1
admin_only_messages
boolean
lock_settings
boolean
admin_approval
boolean
admin_add_only
boolean
description
string
Minimum string length: 1
picture
string
Minimum string length: 1
disappearing_messages
Allowed value: "24h"

Response

200

Successful response