> For the complete documentation index, see [llms.txt](https://help.1msg.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.1msg.io/docs/api-1msg/group-messaging-api-beta.md).

# Group Messaging API (⚡️Beta)

**Group Messaging API** is a beta feature of WhatsApp Business API that lets you create group chats and exchange messages with multiple participants via API.

The feature extends standard 1:1 WhatsApp conversations and is intended for limited group interaction scenarios.

{% hint style="warning" %}

### Access requirements <a href="#access-requirements" id="access-requirements"></a>

To use Group Messaging API, the following conditions must be met:

* The WhatsApp Business account has [**Official Business Account (OBA)** status.](https://help.1msg.io/docs/obtaining-the-green-checkmark-badge)
* Business-initiated message limit: **at least 100,000 messages per 24 hours.** You can check your limit using the [/status](https://docs.1msg.io/#tag/Channel/operation/getStatus) method.
  {% endhint %}

### Creating and joining groups <a href="#creating-and-joining-groups" id="creating-and-joining-groups"></a>

{% stepper %}
{% step %}

#### Create a group <a href="#step-1-create-a-group" id="step-1-create-a-group"></a>

The group is created via the 1MSG API.\
When created, a **unique invite link** is generate
{% endstep %}

{% step %}

#### Join a group <a href="#step-2-join-a-group" id="step-2-join-a-group"></a>

**Joining a group is only possible via the invite link.**

You send the invite link to the required phone numbers; the user decides whether to join the group.

Currently, only up to 8 participants per group are accepted.&#x20;
{% endstep %}

{% step %}

#### Exchanging messages in the group <a href="#step-3-exchanging-messages-in-the-group" id="step-3-exchanging-messages-in-the-group"></a>

Sending messages to the group is done through the standard endpoint, as in standard 1:1 chats. The only difference is that the chatID changes in length and ends with `@g.us`.
{% endstep %}

{% step %}

#### Receiving messages and statuses <a href="#step-4-receiving-messages-and-statuses" id="step-4-receiving-messages-and-statuses"></a>

Incoming messages from groups are delivered to the standard webhook.
{% endstep %}
{% endstepper %}

### Beta version limitations <a href="#beta-version-limitations" id="beta-version-limitations"></a>

#### Group limitations <a href="#group-limitations" id="group-limitations"></a>

* Maximum participants per group: **up to 8**
* Maximum groups per phone number: **up to 10,000**
* Supported message types:
  * Text messages
  * Media messages
  * Template messages (text / media templates)

### Support <a href="#support" id="support"></a>

Group Messaging API is in **beta**. **The feature is not recommended for business-critical processes.**

If you encounter errors or unstable behavior with Group Messaging API — **contact support**.

### Groups API methods (1msg.io) <a href="#groups-api-methods-1msgio" id="groups-api-methods-1msgio"></a>

The **Groups** section contains methods for managing group chats. All methods work via API and allow you to create, update, view, and delete groups, as well as manage participants and invite links.

Documentation:

{% embed url="<https://docs.1msg.io/#tag/Groups>" %}

Summary of methods:

* **Create a Group:** Creates a new group. Returns the ID of the created group and other metadata.
* **Get Groups List:** Returns a list of all groups created on the current channel.
* **Get Group Info:** Retrieves detailed information about a specific group by its ID.
* **Update Group:** Updates parameters of an existing group (e.g. name, description).
* **Delete Group:** Deletes a group.
* **Get Invite Link:** Returns the current invite link for the group (for inviting participants).
* **Reset Invite Link:** Generates a new invite link for the group, replacing the old one. Useful for invalidating previous invites.
* **Remove Participants:** Removes one or more participants from the group.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.1msg.io/docs/api-1msg/group-messaging-api-beta.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.