WhatsApp API for Group Chat: Complete Business Guide

The WhatsApp API for group chat, also called the WhatsApp Groups API, lets eligible businesses with an Official Business Account create and manage small groups through the Cloud API. Businesses can share invite links, manage participants, send supported messages, and use group webhooks, subject to Meta’s limits, pricing, and platform rules.

Introduction

Managing traditional WhatsApp groups still requires considerable manual effort. Businesses must create groups, invite participants, and manage conversations individually.

The WhatsApp API for group chat changes that approach.

Meta’s WhatsApp Groups API enables eligible businesses to manage small groups programmatically through the WhatsApp Business Platform and Cloud API.

However, access is restricted and comes with specific requirements. Group size, supported messages, webhooks, pricing, and account eligibility all affect implementation.

This guide explains how the Groups API works in practice. You will learn who can access it, what businesses can do, how messaging works, which limits apply, and how to build compliant group workflows.

What Is the WhatsApp Group Chat API?

The WhatsApp group chat API is Meta’s official Groups API for businesses. It allows eligible businesses to create and manage small groups programmatically.

Through the WhatsApp Groups API, businesses can create groups, generate invite links, manage participants, and send supported messages. These actions run through the WhatsApp Business Platform and Cloud API.

This differs from regular WhatsApp chatbots, which mainly automate one-to-one conversations. Groups API workflows support shared conversations between multiple participants.

WhatsApp API Group vs Native WhatsApp Group

Native groups depend mainly on manual actions inside WhatsApp. A WhatsApp API group chat uses supported API operations and backend logic instead.

The key difference is control. Native groups prioritize manual participation, while the WhatsApp API for group chat enables structured business workflows through supported API operations.

Not every business account has access, so eligibility is the next thing to verify.

Who Can Access the WhatsApp Groups API?

To use WhatsApp Groups API features, your business must have an Official Business Account (OBA). However, Cloud API access alone does not make a business eligible. Access also depends on the correct app, account, and webhook configuration.

WhatsApp Groups API Eligibility Requirements

Beyond OBA status, your setup must include:

• Cloud API: The business phone number must use WhatsApp Cloud API.
• App permission: The app needs the whatsapp_business_messaging permission.
• WABA configuration: The app must subscribe to the relevant WhatsApp Business Account.
• Webhook setup: A webhook server must receive Cloud API events.
• Group webhooks: The app should subscribe to the required Groups webhook fields.

If your Cloud API environment isn't ready, set up the WhatsApp Business API first.

Accounts and Configurations Not Supported

Some configurations cannot use WhatsApp Business API groups:

• Coexistence users are not supported.
• Numbers onboarded to Multi-Solution Conversations are not supported.
• The Calling API cannot be used inside groups.

With eligibility confirmed, the next step is to understand what businesses can manage through the Groups API.

What Can Businesses Do With the WhatsApp Groups API?

The WhatsApp Groups API supports both group management and group messaging. Businesses can control key group actions through API requests and webhook events.

These capabilities cover the full group lifecycle, from creation to ongoing communication.

Group Management Capabilities

Businesses can use the WhatsApp API for groups to:

• Create groups: Create new business-managed WhatsApp groups programmatically.
• Delete groups: Remove groups that are no longer needed.
• Retrieve group information: Access details about a specific group.
• List active groups: Retrieve groups managed by the business number.
• Generate invite links: Create links that participants can use to join.
• Reset invite links: Replace an existing link when required.
• Remove participants: Remove specific users from managed groups.
• Enable join requests: Require approval before participants enter.
• Approve or reject requests: Control pending participant requests.
• Update group settings: Modify supported group configuration details.

Group Messaging Capabilities

The WhatsApp group messaging API also supports ongoing group communication. Businesses can:

• Send supported messages to groups.
• Receive messages sent by participants.
• Pin important messages.
• Unpin messages when they are no longer relevant.
• Receive messaging and status updates through webhooks.

Together, these capabilities provide structured control over group operations and communication. However, that control comes with specific limits and unsupported actions that shape how groups can be designed.

WhatsApp Groups API Limits and Restrictions

The WhatsApp Groups API is built for controlled, small-group communication. Its limits shape how businesses create groups, admit participants, and communicate at scale.

Understanding these boundaries helps businesses choose suitable workflows before implementation.

Key WhatsApp Group API Limits

The WhatsApp Group API currently applies these core limits:

• Maximum 8 participants: Each group can include up to eight participants.
• Maximum 10,000 groups: One business number can manage up to 10,000 groups.
• One Cloud API business: Only one Cloud API business can manage each group.
• Invite-only joining: Participants must join using a group invite link.

Unsupported Messages and Actions

Several WhatsApp features are not supported in API-managed groups:

• Calling
• Disappearing messages
• View-once messages and media
• Authentication messages and templates
• Commerce messages
• Interactive messages
• Hiding the participant list
• Editing sent messages
• Deleting sent messages
• Marking messages as read through the API

These restrictions make Groups API workflows better suited to focused conversations. Within these boundaries, businesses can still support practical use cases across customer engagement, coordination, and structured group communication.

Why Businesses Use the WhatsApp Groups API

The WhatsApp Groups API gives businesses more control over small-group communication. It replaces repeated manual tasks with structured, programmatic workflows.

This makes the API useful when conversations need clear segmentation and controlled participation.

Key Business Benefits

Businesses can use the WhatsApp API for group chat to:

• Create groups programmatically: Launch groups automatically when specific events occur.
• Reduce repetitive administration: Avoid manually creating and managing every group.
• Segment conversations: Keep customers in smaller, purpose-specific groups.
• Connect backend systems: Link group actions with CRMs and business workflows.
• Standardize group management: Apply consistent rules across multiple groups.
• Keep joining user-controlled: Participants enter through invite links.
• Trigger event-based actions: Start workflows after signups, purchases, or registrations.

These benefits are especially useful when businesses manage multiple short-lived groups.

Common Business Use Cases

The Groups API fits use cases where smaller, focused conversations matter.

• VIP or premium groups: Create controlled spaces for selected customers.
• Cohort-based learning: Organize learners by course, batch, or program.
• Coaching and roundtables: Manage small expert-led discussion groups.
• Beta and early-access groups: Collect structured feedback from selected users.
• Customer service pods: Coordinate focused discussions around specific customer needs.
• Event coordination: Create groups for attendees, locations, or breakout sessions.
• Feedback and research groups: Gather input from targeted participant segments.

Each use case depends on the same foundation: creating and managing groups reliably. Next, learn how to create a group through the API.

Support WhatsApp Group Workflows With BotPenguin
Explore WhatsApp Automation

How to Create a WhatsApp Group Using API

The WhatsApp API group creation process starts after eligibility is confirmed. Businesses then configure Groups access within their Cloud API environment.

The process works in five steps:

Step 1. Confirm eligibility: Ensure the business meets Groups API access requirements.

Step 2. Configure Groups access: Complete the required Cloud API and app setup.

Step 3. Create the group: Send a group-creation request through the API.

Step 4. Receive group details: The response provides the group ID and invite link.

Step 5. Store the group ID: Use it for future group management actions.

This approach makes group creation repeatable across structured business workflows.

What Happens After a Group Is Created?

Each new group receives a unique group ID. You use this identifier for subsequent API operations.

The business also receives an invite link for participants to join. You can then manage supported group settings through later requests.

Lifecycle updates are delivered through the relevant group webhook. These events help track important changes throughout the group lifecycle.

The stored group ID can then support actions like retrieving information, updating settings, or managing participants.

Once the group exists, the next step is adding participants correctly.

How to Add Users to a WhatsApp Group Using API

The WhatsApp API add-to-group flow is invite-based. Businesses cannot directly force-add customers into an API-managed group.

Instead, participants receive a group invite link and choose whether to join.

Generate and Manage Group Invite Links

A group invite link is generated for each API-managed group. Businesses can retrieve the link whenever needed.

Businesses can also reset the link if access needs to change. Businesses can then share it through suitable customer communication channels.

This keeps participation user-controlled while supporting automated onboarding workflows.

Manage Join Requests

Businesses can also enable approval before participants enter a group.

When join approval is active, businesses can:

• View pending join requests.
• Approve eligible participants.
• Reject unwanted requests.
• Remove participants after they have joined.

This adds another layer of control for groups that require restricted access.

Once the right participants have joined, businesses can begin sending supported messages through the Groups API.

How to Send Messages to WhatsApp Groups via API

The WhatsApp API group messaging flow supports selected message formats. Businesses can send updates, media, and approved templates to eligible groups.

The exact format matters because Groups does not support every WhatsApp message type.

Supported Group Message Types

The WhatsApp group messaging API supports:

• Text messages: Standard text-based group communication.
• Media messages: Supported images, videos, documents, and other media.
• Text-based templates: Approved templates containing text content.
• Media-based templates: Approved templates containing supported media.

Using Message Templates in Groups

Templates used for group messaging should be created with Groups in mind.

Meta advises against simply reusing one-to-one templates without considering group-specific restrictions.

Interactive, authentication, and commerce formats remain unsupported in Groups.

Delivery and Read Status for Group Messages

Group templates do not provide the same template performance metrics available elsewhere.

However, businesses can still receive message status webhooks for:

• Sent messages
• Delivered messages
• Read messages

You can also aggregate these delivery and read statuses across group participants.

These status updates depend on webhooks, which become central to monitoring group activity and lifecycle events.

How WhatsApp Groups API Webhooks Work

Webhooks keep your backend updated when something changes inside a group. With the WhatsApp Groups API, businesses can respond to these events without repeatedly checking group activity.

Meta provides four group-specific webhook fields:

• group_lifecycle_update: Tracks group creation and deletion events.
• group_participants_update: Tracks joins, exits, removals, and join requests.
• group_settings_update: Reports changes made to supported group settings.
• group_status_update: Reports status changes, including suspension-related events.

These updates help connected systems stay synchronized with group activity. They can trigger actions when participants join, settings change, or group status updates occur.

This event-driven setup is what makes automated group workflows practical at scale.

How to Automate WhatsApp Group Workflows

The WhatsApp Groups API becomes more useful when connected to business systems. Group events can trigger actions across CRMs, forms, and internal workflows.

This turns separate API actions into repeatable, event-driven processes.

Example WhatsApp Groups API Workflow

A typical automated workflow can follow this sequence:

1. A user registers for an event or program.

2. The backend creates or selects the appropriate group.

3. The system sends the user an invite link.

4. The user voluntarily joins the group.

5. A webhook confirms the participant update.

6. The workflow sends the relevant group message.

7. The CRM or connected system records the event.

This structure reduces manual coordination while keeping participation controlled. A real example comes from Valoon, a German construction software company.

This keeps familiar WhatsApp communication connected with organized project records.

Where WhatsApp Automation Platforms Fit

Automation platforms can handle related customer journeys beyond group-specific operations.

BotPenguin is a no-code AI automation platform used by 80,000+ businesses across 193 countries. Its WhatsApp chatbot platform supports lead generation, sales, marketing, bookings, and customer support.

Businesses can also connect WhatsApp conversations with tools such as CRMs and other business applications. This helps keep customer data and follow-up workflows connected across the broader communication journey.

Once you map these workflows, pricing becomes the next practical consideration.

Automate WhatsApp Group Journeys With BotPenguin
Start Now

WhatsApp Groups API Pricing

The WhatsApp Groups API follows Cloud API’s per-message pricing model. Charges depend on message category, delivery, and recipient market.

For billable messages, pricing applies to each successful delivery to a participant. One group send does not automatically equal one charge.

Group pricing uses three categories:

• group_marketing: Marketing template messages.
• group_utility: Utility template messages.
• group_service: Non-template group messages.

Message webhooks also include pricing information for each delivery. They identify the pricing type and applicable category.

For North America, current example rates (as of September 2026) are:

• Marketing: $0.0287 per delivered message
• Utility: $0.0039 per delivered message
• Service: Free when classified as group_service

For example, one marketing template delivered to five participants costs: $0.0287 × 5 = $0.1435. If only four participants receive it, the charge becomes $0.1148.

Rates vary by recipient market. Group utility messages are also excluded from Cloud API volume tiers.

How the Group Customer Service Window Works

When any participant messages the business, a service window opens for the entire group. Another participant message refreshes that same group-wide window.

During an open window:

• Non-template group_service messages are free.
• Utility templates sent within the window are free.
• Marketing templates remain billable.

Outside the window, delivered utility templates are billed at the applicable utility rate.

This group-wide window can directly affect messaging costs. Pricing must therefore be considered alongside compliance before scaling group communication.

WhatsApp Groups API Compliance and Suspension

Using the WhatsApp Group Chat API requires compliance with WhatsApp Business Platform policies. Group workflows must respect participation, messaging, and platform restrictions.

The API is designed for controlled group communication, not unrestricted mass broadcasting.

Businesses should follow these core practices:

• Use invite-based participation: Let users choose whether to join. This keeps group entry voluntary and user-controlled.
• Send supported message formats: Avoid restricted or unsupported message types. This reduces the risk of failed or non-compliant messaging.
• Follow WhatsApp policies: Keep group activity aligned with platform rules. Policy violations can affect continued access to group features.
• Monitor group status: Track enforcement-related changes through group_status_update. This helps teams react quickly when a group’s status changes.
• Respond to suspensions: Review affected workflows before continuing group activity. Suspended groups should not be treated like active communication channels.

Group status can change when Meta applies enforcement actions. Status webhooks help businesses detect these changes quickly.

Following these rules keeps group workflows aligned with the platform’s intended use.

Conclusion

The WhatsApp Groups API brings structured group communication to eligible businesses, but access remains restricted. OBA status is essential, and groups are designed for small, controlled conversations rather than large communities.

Successful implementation depends on more than group creation. Businesses must account for invite-based joining, supported message formats, webhooks, participant limits, and per-message pricing.

Broader WhatsApp automation can reduce manual work across customer conversations, follow-ups, bookings, and connected workflows. BotPenguin helps businesses automate these WhatsApp interactions through no-code tools and connected customer journeys.

Explore BotPenguin when you’re ready to simplify more of your WhatsApp workflows.

Frequently Asked Questions (FAQs)

Who can use the WhatsApp Groups API?

Businesses must have an Official Business Account (OBA) to use the WhatsApp Groups API. They also need the required Cloud API setup, app permissions, WABA configuration, and webhook subscriptions. Standard WhatsApp Business Platform access alone does not qualify.

How many participants can a WhatsApp API group have?

A WhatsApp API group chat supports up to eight participants. This limit makes the feature better suited to small, focused business conversations rather than large communities, mass broadcasts, or high-volume discussion groups.

Can businesses add users directly to WhatsApp API groups?

No. Businesses cannot directly force-add customers through the WhatsApp API add to group process. Participants join using an invite link and decide whether to enter. Businesses can also enable join approval for additional access control.

Can existing WhatsApp groups be managed through the Groups API?

No. You can't simply transfer existing groups created manually in WhatsApp into API management. The Groups API is designed to manage groups created through its supported programmatic workflow and associated Cloud API operations.

What message types are supported in WhatsApp API groups?

The WhatsApp group messaging API supports text messages, media messages, text-based templates, and media-based templates. Group messaging does not support interactive, authentication, or commerce message formats.

Can businesses approve or reject group join requests?

Yes. Businesses can enable join approval for API-managed groups. Businesses can then review, approve, or reject pending requests. Businesses can also remove participants after they join when access needs to change.

Does the WhatsApp Groups API provide delivery and read statuses?

Yes. The WhatsApp Groups API provides message status webhooks for sent, delivered, and read events. You can aggregate these statuses across participants. However, group templates do not provide the same template performance metrics available in other messaging contexts.

How does WhatsApp Groups API pricing work?

WhatsApp Groups API pricing follows Cloud API per-message rates. You're billed for each participant who successfully receives a message. Marketing and utility rates vary by recipient market, while eligible group_service messages can be free during the group customer service window.