> 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)

The group messaging API is in beta testing.

**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.