Group Operations
resource: group — group lifecycle, membership, admins, and broadcast
create
Creates a WhatsApp group.
| Field | Required | Description |
|---|---|---|
subject | ✓ Yes | Group name/subject. |
participantPhoneNumbers | ✓ Yes | Comma-separated list of E.164 phone numbers to add as initial members. |
get
Fetches group details.
| Field | Required | Description |
|---|---|---|
groupId | ✓ Yes | Group ID. |
delete
Deletes/disbands a group.
| Field | Required | Description |
|---|---|---|
groupId | ✓ Yes | Group ID. |
update-name
Renames a group.
| Field | Required | Description |
|---|---|---|
groupId | ✓ Yes | Group ID. |
subject | ✓ Yes | New group name. |
get-members
Lists current group members.
| Field | Required | Description |
|---|---|---|
groupId | ✓ Yes | Group ID. |
add-member
Adds a participant to a group.
| Field | Required | Description |
|---|---|---|
groupId | ✓ Yes | Group ID. |
phoneNumber | ✓ Yes | E.164 phone number to add. |
remove-member
Removes a participant from a group.
| Field | Required | Description |
|---|---|---|
groupId | ✓ Yes | Group ID. |
phoneId | ✓ Yes | Participant's phone/member ID to remove. |
promote-admin
Promotes a member to group admin.
| Field | Required | Description |
|---|---|---|
groupId | ✓ Yes | Group ID. |
phoneId | ✓ Yes | Member ID to promote. |
demote-admin
Demotes a group admin to a regular member.
| Field | Required | Description |
|---|---|---|
groupId | ✓ Yes | Group ID. |
phoneId | ✓ Yes | Member ID to demote. |
get-invite-link
Returns the group's invite link.
| Field | Required | Description |
|---|---|---|
groupId | ✓ Yes | Group ID. |
send-message
Sends a text message to a group.
| Field | Required | Description |
|---|---|---|
groupId | ✓ Yes | Group ID. |
text | ✓ Yes | Message body. |
Groups are outside the standard Cloud API messaging surface: group operations depend on
WhatsApp Business Account group-management capabilities that Meta gates separately from standard
one-to-one/business messaging — availability can vary by WABA and API tier. Confirm your account has
group management enabled before building a workflow around this resource.