Anjali Pandey
The WhatsApp Groups API lets businesses create and manage WhatsApp groups programmatically through the WhatsApp Business Platform.
Access requires an Official Business Account (OBA) and a compatible Cloud API number. The API also has hard limits around group size, group creation, participant management, and messaging.
This guide covers Groups API eligibility, OBA requirements, current limits, pricing, and what to do if the API doesn't fit your use case.
TL;DR - WhatsApp Groups API at a Glance
WhatsApp Groups API Eligibility
To use Groups API, your business needs an Official Business Account (OBA).
But having a verified Meta Business account, an approved WhatsApp display name, or access to the WhatsApp Business Platform does not automatically make you an OBA.
1. What does OBA mean?
Meta uses OBA status for established and notable businesses on WhatsApp. The OBA review considers factors including:
Business verification
An approved display name
Two-step verification on the phone number
How long the business has been active on the WhatsApp Business Platform
Whether the business has a notable, authentic presence
OBA eligibility is separate from simply completing Business Verification.
2. The OBA badge vs the actual API status
There is another detail worth checking if you're validating eligibility through the API.
WhatsApp exposes more than one field related to business account status, including is_official_business_account and oba_status. These do not always tell you the same thing.
A business may see an account marked as an official business account through one field while its oba_status does not show an active OBA state.
If you're building an automated eligibility check, don't rely on a single Boolean field. Check the actual OBA status returned for the business and confirm that the phone number and account meet the Groups API requirements.
This matters because a dashboard or integration can otherwise show a business as "official" while the account still cannot use Groups API.
3. You need a Cloud API number
Groups API works with WhatsApp Cloud API numbers.
A number that runs through the WhatsApp Business app cannot use Groups API. Meta also does not currently support Groups API with Coexistence.
So if a business currently manages its number through the WhatsApp Business app, it cannot simply connect that same setup to Groups API. The number needs a compatible Cloud API setup.
Quick eligibility checklist Before building around Groups API, confirm that:
|
|---|
Try Periskope
Manage WhatsApp Groups, Chats and Numbers at Scale
WhatsApp Groups API Limits and Restrictions
Once your business qualifies, the next question is whether the API fits your actual workflow.
1. Up to 8 participants per group
A Groups API group supports up to 8 participants, including the business number. That leaves room for up to 7 other participants.
That makes the API a better fit for small, focused conversations than large customer communities.
For example:
A customer + support team
A small project team
A dealer + account managers
A small group of customers working through an onboarding process
If you need a WhatsApp group with 50 or 500 members, this limit rules out the Groups API.
2. Up to 10,000 groups per business number
A single WhatsApp API business number can create up to 10,000 groups through the Groups API.
One more rule to know: a group can only belong to one Cloud API business. Two different business accounts can't share or co-manage the same group.
3. Participants join through an invite
Groups API does not let the business directly add participants to a group.
When you create a group, WhatsApp generates an invite link. You can send that link to potential participants, and you can also enable join-request approval if you want to review requests before people enter.
For example, a company could create a group for a new customer and send the customer an invite link through an approved WhatsApp template.
4. Only 3 messages can be pinned
Groups API supports pinned messages, with a maximum of 3 pinned messages per group.
If you pin a fourth message, WhatsApp automatically unpins the oldest one. Each pin can remain active for 1 to 30 days.
5. Groups API has its own rate limits
Groups API operations have their own rate limits. If a phone number performs too many group operations in a short period, the API can return error 131208, Group Rate Limit Hit.
This is separate from your general Cloud API messaging throughput. A high messaging throughput does not remove Groups API operation limits.
6. Meta can temporarily disable group creation
Meta can temporarily stop a business from creating new groups if it detects excessive marketing messages sent by the WABA within the customer service window over the previous 7 days.
This appears as error 131214.
If your workflow depends heavily on creating new groups, this is a limit worth planning for.
How WhatsApp Groups API Pricing Works
Normal WhatsApp Cloud API pricing charges you based on the conversation you open with each person you message.
One person, one billable conversation.
Groups work differently.
When you send a message into a group, WhatsApp bills it as a separate delivery to each person in that group, not as one message.
So sending one update into a full 8-person group (your business plus 7 others) counts as 7 billable deliveries, not 1.
Example: A business sending 100 updates a month into one full 8-person group isn't paying for 100 messages. It's paying for up to 700 billable deliveries, the same total spend as sending 700 individual 1:1 messages.
Cost scales with total people reached across all your groups, not with how many times you hit send.
What to Do If You Don't Qualify, or Outgrow the Limits
If your business doesn't have OBA status yet, runs on the WhatsApp Business app, or uses Coexistence, the Groups API isn't available to you right now, regardless of how solid your setup is otherwise.
And even with OBA status, the 8-participant cap rules out anything bigger than a small, structured group.
A support escalation with a handful of people works. A community, a cohort, or a customer group of any real size doesn't fit.
If you already have active WhatsApp groups, Periskope gives teams a way to manage them at scale.
It connects regular WhatsApp and WhatsApp Business numbers through WhatsApp's linked-device setup, so teams can manage the groups and chats those numbers already use.
You can bring those conversations into a shared workspace, assign tickets and tasks, route messages to team members, automate workflows, and manage thousands of WhatsApp groups from one place.
That makes it useful for businesses that already have active WhatsApp groups and want to manage them with a team, rather than creating new groups through Groups API.
For a detailed comparison of the two approaches, see Normal WhatsApp Groups vs WhatsApp Groups API.
FAQs
1. What does it mean to have an Official Business Account (OBA) on WhatsApp?
An OBA is a status Meta grants to established, notable businesses on the WhatsApp Business Platform.
It requires business verification, an approved display name, two-step verification, and a track record on the platform, but meeting those doesn't guarantee OBA status on its own.
2. Why does my business show as verified but still can't access the Groups API?
Business verification and OBA status aren't the same thing. Check the oba_status field directly rather than relying on a badge, which can appear through Meta Verified without full OBA approval.
3. Can I use the WhatsApp Groups API with the WhatsApp Business app?
No. Groups API requires a standard Cloud API number. It isn't available on Business app numbers or Coexistence setups.
4. Does WhatsApp Groups API require 100,000 messages a day?
No. Meta's current Groups API documentation does not list a 100,000-message threshold as a separate requirement. OBA status is the key business-account eligibility requirement, alongside the required Cloud API setup.
5. How many groups can a WhatsApp business number create?
Up to 10,000 groups per business number.
6. How is WhatsApp Groups API pricing calculated?
Per recipient, not per message sent. A message to an 8-person group bills as up to 7 deliveries, not one.
7. Why can't I add a participant directly to a WhatsApp Groups API group?
There's no add-participant endpoint. Participants join through an invite link, which they have to accept themselves.
8. Can I move an existing WhatsApp group to the Groups API?
No. Groups API is designed to create new API-managed groups and does not provide a way to import an existing WhatsApp group or its member list. If you already have active WhatsApp groups, Periskope can manage those existing groups without requiring a migration.
Start a free trial to see how it works on your own groups.
