> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hookmyapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp groups

> Create and run WhatsApp groups from your business number.

Your business number can create WhatsApp groups, send messages to them, and manage who is in them.\

You do it with the API, the CLI, or your AI agent. There is no dashboard screen for groups.

## What you can do

* Create, rename, and delete groups
* Set a group description and photo
* Send text, media, and templates to a group
* Share an invite link, and approve or reject join requests
* Remove members
* Get an event when someone joins, leaves, or asks to join

## How groups work

* Your business number creates the group and is its only admin.
* You can't add people directly. They join through the invite link.
* A removed member can't rejoin with the invite link.

## Limits

| Limit | Value |
| - | - |
| Members per group | 8 |
| Groups per number | 10,000 |
| Subject | 1 to 128 characters |
| Description | Up to 2048 characters |
| Photo | JPEG, square, at least 192 px, up to 5 MB |
| Pinned messages per group | 3 |
| Members removed per call | 8 |

## Who can use groups

Groups need a number on the Cloud API with Official Business Account status.\

A number you also use in the WhatsApp Business app can't use groups.

Read `whatsappGroups` on the channel to check a number before you build.

```bash REST theme={null}
curl https://api.hookmyapp.com/meta/channels/ch_AbCdEf12 \
  -H "Authorization: Bearer hmok_..." \
  -H "X-Workspace-Id: ws_..."
```

```bash CLI theme={null}
hookmyapp channels show 15551234567 --json
```

```text MCP theme={null}
get_channel
```

```json theme={null}
"whatsappGroups": { "available": false, "reason": "whatsapp_business_app_number" }
```

`reason` is `null` when `available` is `true`. Otherwise it is one of:

| Reason | What it means | What to do |
| - | - | - |
| `whatsapp_business_app_number` | The number is also used in the WhatsApp Business app | Use a number that is only on the Cloud API |
| `not_on_cloud_api` | The number is not on the Cloud API | Connect it on the Cloud API |
| `not_official_business_account` | The number is not an Official Business Account | Get Official Business Account status from Meta |
| `unknown` | We have not read the number's status yet | Make a groups call. It works if the number qualifies |

This check is advice. It never blocks a call. If a number was just approved, call the API and it works.

A call to a number that can't use groups returns `400 WA_GROUPS_NOT_ELIGIBLE`.

## Next

* [Manage groups](https://docs.hookmyapp.com/whatsapp/groups/manage.md)
* [Send to a group](https://docs.hookmyapp.com/whatsapp/groups/send.md)
* [Group events](https://docs.hookmyapp.com/whatsapp/groups/events.md)
* [Automated groups](https://docs.hookmyapp.com/whatsapp/groups/automated-groups.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.