WhatsApp Groups on the Business API: 8 Participants, Not 1,024
The Groups API caps a group at 8 participants, will not let you add anyone directly, and needs an Official Business Account. The documented rules.
Published
Almost everyone who discovers that the WhatsApp Business Platform has a Groups API arrives with the same plan: move the 900-member customer group off someone's personal phone and run it properly through the API. It is a reasonable plan and it will not work, for a reason that takes one number to explain.
A group created through the Groups API holds a maximum of 8 participants. The consumer WhatsApp app allows over a thousand. You also cannot add anyone to an API group — participants have to accept an invite link themselves — and the whole feature requires your business to be an Official Business Account, which is a higher bar than most people expect and is not a permission you can simply request. Everything below is from Meta's Groups API documentation and the group management reference.
The documented limits
| Limit | Value |
|---|---|
| Max group participants | 8 |
| Max groups per business number | 10,000 |
| Max Cloud API businesses per group | 1 |
| Supported message types | Text, media, text-based templates, media-based templates |
| Group subject | Up to 128 characters |
| Group description | Up to 2,048 characters |
| Group picture | JPEG only, 5 MB max, square, minimum 192×192 |
What this does and does not replace
The groups you already know, in the consumer and Business apps, are a different product with different rules. Lining them up side by side is the fastest way to work out whether the API is the thing you actually want:
| What you want to do | WhatsApp app groups | Groups API |
|---|---|---|
| Hold hundreds of members in one group | Yes | No — 8 is the ceiling |
| Add a contact to the group yourself | Yes | No — invite link only, they must accept |
| Create groups automatically, in volume | No | Yes — up to 10,000 per number |
| Know programmatically who joined or left | No | Yes — four webhook events report it |
| Send an approved template into the group | No | Yes — text and media templates both work |
| Run it from the WhatsApp Business app | Yes | No — Cloud API numbers only |
| Reach many people with one message | Yes, manually | Wrong tool — use broadcasts instead |
That last row matters more than the rest. If the goal is one message reaching a large audience, groups are the wrong mechanism entirely and broadcasts are the right one — with their own rules, which we covered in WhatsApp broadcast limits, rules and cost.
Who can actually use it
Here is the part that is commonly misunderstood, including by people who have read about the feature. The gate is not a special groups permission. Meta's prerequisites ask for the standard whatsapp_business_messaging permission — the same one that already covers your normal messaging. What actually decides whether you can use groups is account status:
- Official Business Account status is required. Meta's wording is that the Groups API is open to all businesses with an OBA. No OBA, no groups, with any provider.
- The number must be on Cloud API, not the WhatsApp Business app.
- Numbers onboarded to Multi-solution Conversations are excluded, as are WhatsApp Business app numbers.
- A webhook server is required, subscribed to four group fields: group lifecycle, participants, settings and status updates.
- Your app must be subscribed to the Messaging account of the business phone number.
If you are shopping providers on the strength of group support, that list is the thing to check first — because the blocker is almost never the platform. WABPO supports groups, and it still cannot hand you an OBA; nobody can shortcut that, in the same way nobody can speed up template review.
You cannot add anyone. They have to come in.
This is the second surprise, and it is a design decision rather than an oversight. Meta's reference is blunt about it: since you cannot manually add participants to the group, you send your invite link to the people you would like to join. So a group is never something you assemble from your contact list — it is something people opt into, one tap at a time.
- Create the group with join approval off, and anyone holding the invite link joins immediately.
- Create it with join approval on, and people submit join requests that you approve or reject.
- You can send the invite link as an approved template message, which is how it reaches people at any scale.
- Resetting the invite link invalidates every previous link. Useful when a link leaks; destructive if you have printed it somewhere.
- A participant you remove cannot rejoin using an invite link. Removal is closer to a ban than a tidy-up.
What you can manage programmatically
The management surface is small and complete enough to run groups unattended: create and delete a group, get or reset the invite link, send the invite link as a template, approve or reject join requests, remove participants, read a single group's info, list the active groups on a number, and update the subject, description or picture. Messages can also be pinned and unpinned. Those nine operations plus the four webhooks are the whole feature.
When an eight-person group is the right tool
Eight sounds restrictive until you count the people actually involved in a single piece of work. A property viewing is a buyer, perhaps their partner, an agent and a photographer. A vehicle repair is the owner, the service advisor and the technician. A wedding order is the couple, the planner and two people from your side. Those groups are small because the work is small, and the thing they need is not reach — it is everyone seeing the same messages instead of the account manager relaying them.
So the honest test is whether your use case is coordination or distribution. Coordination among a handful of named people, created fresh for each job and deleted when it closes, is exactly what the shape of this API suggests it was built for. Distribution to an audience is broadcasts, and trying to force it into groups will produce ten thousand groups of eight people and a support problem. One more caveat worth stating: Meta's groups messaging documentation does not currently spell out how the 24-hour customer service window applies inside a group, so do not assume group messages behave like one-to-one conversations for pricing or window purposes until that is confirmed.
Frequently asked questions
How many people can be in a WhatsApp group created via the API?
Eight. Meta documents the maximum group participants for the Groups API as 8, which is far below the consumer WhatsApp app's limit of over a thousand. No Business Solution Provider can raise it, so if your plan needs a large group, the Groups API is not the mechanism — broadcasts are.
Can I add contacts to a WhatsApp group through the API?
No. Meta's reference states that you cannot manually add participants, so you send your invite link to the people you want to join and they accept it themselves. Groups are opt-in by design, which also means you cannot rebuild an existing group from a contact list.
Does the Groups API need a special permission from Meta?
Not a special permission — the prerequisite is the standard whatsapp_business_messaging permission you already use for messaging. The real requirement is Official Business Account status for your business, plus a Cloud API number and a webhook server subscribed to the four group fields. OBA is the gate people underestimate.
Can I use groups with the WhatsApp Business app?
No. Groups are not available for WhatsApp Business app phone numbers, or for numbers onboarded to Multi-solution Conversations. The number has to be in use with Cloud API.
How many groups can one business number create?
Up to 10,000 per business phone number. Read that alongside the 8-participant cap and the intended shape becomes clear: many small groups rather than a few large ones — one per order, project, repair or booking.
What happens if I reset a group invite link?
Every previous invite link becomes invalid immediately. That is what you want if a link has leaked beyond the people you intended, and a problem if the old link is printed on something or embedded in a message you already sent. Separately, a participant you remove from a group cannot rejoin using an invite link.
Written by
Saifullah AlamFounder — Spadasoft, WABPO & WAWCD
Saifullah Alam founded Spadasoft, WABPO and WAWCD. He builds WhatsApp Business API products and writes practical, no-hype guides about what actually ships.
Keep reading
WhatsApp Broadcast Limit, Rules and Cost: What's Free and What's Not
256 contacts per list, saved-contact rules, and Meta fees — here are the real WhatsApp broadcast limits, what's free, what's paid, and copy-paste message examples.
WhatsApp Template Rejected? Every Reason Meta Sends, Explained
Meta rejects a template and hands you a single word: INCORRECT_CATEGORY, INVALID_FORMAT, SCAM. Here is what all eight of those words mean, why three of them are indistinguishable in Meta's own docs, and which one does not mean rejected at all.
WhatsApp Business API: A Beginner's Guide in Plain English
API sounds technical, but the idea is simple: it's WhatsApp built for businesses that outgrew the app. Here's everything a beginner needs to know.
