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.

circle-exclamation

Access requirements

Creating and joining groups

1

Create a group

The group is created via the 1MSG API. When created, a unique invite link is generate

2

Join a group

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.

3

Exchanging messages in the group

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.

4

Receiving messages and statuses

Incoming messages from groups are delivered to the standard webhook.

Beta version limitations

Group limitations

  • 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

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)

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:

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.

Last updated