Add and Remove WhatsApp Group Members
Groups are the part of WhatsApp the official Cloud API never reached: there is no endpoint to create one, administer it or read its members. Wapito drives a linked number instead, so a group is an ordinary REST call.
Can the official WhatsApp Cloud API do this?
No. The official API cannot add or remove group members.
Read the full comparisonHow it works
List who is actually in the group, add the missing people, remove the ones who left, and reconcile from the participants webhook.
Read the current membership
Always start from the real list rather than from your own copy. Members join by link, leave on their own, and are removed by other admins, so a database that has not seen a participants event in a while is usually out of date.
API reference for this stepAdd the people who are missing
Send the numbers in a single call and read the per-participant result. Some will be added, some will be invited instead because their privacy settings forbid direct adds, and some will fail outright - the response says which is which.
API reference for this stepRemove someone who has left the team
Removal is immediate and the person sees that they were removed. Do it from a scheduled job that reads your own source of truth, so nobody is removed because of a transient CRM sync failure.
API reference for this stepReconcile from the webhook
Every join, leave, add and remove arrives as an event carrying the action and the participant, who may be a linked identity rather than a phone number. Apply it to your own records so the two never drift apart.
curl --request GET \
--url https://api.wapito.com/v1/groups/120363041234567890@g.us/participants \
--header 'Authorization: Bearer wpt_YOUR_TOKEN'Endpoints
Webhook events
groups.participantsGroup membership or role changedonGroupsParticipants()
What you can build with it
- Keep a team group in step with the rota
A logistics firm syncs its shift group with the rota every morning: whoever is on today is added, whoever finished yesterday is removed. The job reads the live participant list first, so a driver who joined by link is never removed for being unexpected.
- Offboard an employee everywhere at once
When HR marks someone as leaving, an automation removes them from every internal WhatsApp group the company runs, in the same pass that revokes their other access. The group ids come from the company's own registry rather than from a search.
- Move paying members into the subscriber group
A membership site invites new subscribers to the members-only group when payment clears, and removes them when a subscription lapses after the grace period. Invites go out as links so nobody is pulled into a group without acting.
What the official WhatsApp Cloud API does here
Meta's official WhatsApp Cloud API is built for business messaging: templates, customer-service windows and per-conversation pricing. A large part of what WhatsApp itself can do — groups, channels, status, presence, contact lookups — has no endpoint there at all, which is why so many teams end up looking past it. Everything below is checked against Meta's own published reference, with the link and the date we checked it.
Not possible on the Cloud API
No. The official API cannot add or remove group members.
Because Meta's Cloud API documents no group endpoints at all, there is nothing to add a participant to. Membership management is a client capability, which is why every team that needs it either does it by hand on a phone or uses an API that speaks the protocol directly.
Paraphrase (not a verbatim quote), checked against the Cloud API reference index: no node or edge for listing, adding or removing group participants appears in the reference.
The official workaround
None. Teams on the official platform maintain the group by hand on a phone and use the API only for the individual messages around it, which means the membership in WhatsApp and the membership in their own system are reconciled by a person.
Wapito is an independent product. It is not affiliated with, endorsed by, sponsored by or certified by WhatsApp or Meta Platforms, Inc. WhatsApp is a trademark of Meta Platforms, Inc.
Gotchas
- A successful call does not mean everyone was added. Read the per-participant status: people whose privacy settings block direct adds are sent an invite instead, and they are not in the group until they accept.
- Participants can arrive as linked identities rather than phone numbers, so match on the linked identity first and treat the phone number as an enrichment that may be absent.
- The linked number must be an admin. Another admin can demote it from their phone at any moment with no notification, so check the role before a batch rather than halfway through it.
Tutorials by language
Automations and integrations
Frequently asked questions
Why are some people invited instead of added?
WhatsApp lets everyone choose who may add them to groups. If a person has restricted that to their contacts, an add from an unknown number becomes an invitation they have to accept. The API reports this per participant, so your code can tell the difference between someone who is in the group and someone who has merely been asked.
Is there a limit to how many I can add at once?
The group itself has a member ceiling set by WhatsApp, and practical experience says that adding many people in quick succession draws attention regardless of the ceiling. Add in small batches with a pause between them, and if the group is large, publish an invite link and let people join at their own pace.
Can I re-add someone who left?
Yes, technically, but think about whether you should. Someone who left a group and is immediately put back in is very likely to report the number, and repeated re-adds of the same person are a strong abuse signal. Send them the invite link instead and let them decide.
How do I know if someone was removed by another admin?
The participants webhook carries every membership change, including ones made by other admins from their phones, with the action and the participant. Subscribing to that event is the only reliable way to keep your own records accurate, because nothing about a change made on someone else's phone reaches you otherwise.
Related
Related features
Errors you may hit
Glossary
Try it on your own number
Create a channel, link a WhatsApp number by QR or pairing code, and call the API in a couple of minutes. The Sandbox plan is free and needs no card.