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

# Group events

> Get an event when a group is created, someone joins or leaves, or a join request arrives.

Group activity arrives as the event type `whatsapp.group.updated`.\

Subscribe to it like any other type. See [event subscriptions](https://docs.hookmyapp.com/whatsapp/event-subscriptions.md).

## Changes

Each event has a `change` that says what happened. Member changes send one event per member.

| `change` | Sent when |
| - | - |
| `created` | A group was created. Carries `subject` and `inviteLink` |
| `create_failed` | A group could not be created. Carries `error` |
| `deleted` | A delete you asked for finished. `succeeded` says whether it worked |
| `member_joined` | Someone joined |
| `member_left` | A member left |
| `member_removed` | You removed a member. `succeeded` says whether it worked |
| `join_requested` | Someone asked to join an `approval_required` group |
| `join_request_revoked` | Someone took back their request |
| `settings_updated` | A subject, description, or photo change finished. `succeeded` is `true` when every field worked |
| `suspended` | WhatsApp suspended the group |
| `suspension_cleared` | The suspension ended |

## Fields

`data` holds:

| Field | Meaning |
| - | - |
| `groupId` | The group |
| `requestId` | The `requestId` your call returned, when you started this change. `null` otherwise |
| `change` | One of the values above |
| `timestamp` | When it happened |
| `subject`, `inviteLink` | On `created` |
| `member` | `{ waId, userId }` on member and join changes. `waId` is the phone number. `userId` is set when the member has hidden their phone number |
| `joinRequestId` | On `join_requested` and `join_request_revoked` |
| `succeeded` | On `create_failed`, `deleted`, `member_removed`, and `settings_updated` |
| `error` | `{ code, message }` when something failed |
| `settings` | On `settings_updated`: the outcome for each of `subject`, `description`, and `profile_picture` |

Fields that don't apply are `null`.

## Match an event to your call

Create, update, photo, remove, and delete calls return a `requestId`.\

The event with the same `requestId` tells you how it went.

```json whatsapp.group.updated theme={null}
{
  "id": "evt_5c2d8e1f-7a3b-5d9c-8e4f-2b1a0c9d8e7f",
  "type": "whatsapp.group.updated",
  "occurredAt": "2026-10-21T09:30:00.000Z",
  "channelId": "ch_AbCdEf12",
  "channel": { "type": "whatsapp" },
  "data": {
    "groupId": "GROUP_ID",
    "requestId": "REQUEST_ID",
    "change": "created",
    "timestamp": "2026-10-21T09:30:00.000Z",
    "subject": "Order 1042",
    "inviteLink": "https://chat.whatsapp.com/LINK_ID",
    "member": null,
    "joinRequestId": null,
    "succeeded": null,
    "error": null,
    "settings": null
  },
  "raw": { "object": "whatsapp_business_account", "entry": [] },
  "rawOmitted": false
}
```

## groupId and participant on message events

Two existing event types gain fields for groups.

| Event | New field | Meaning |
| - | - | - |
| `whatsapp.message.received` | `groupId` | The group the message was sent in. `null` for a 1:1 message |
| `whatsapp.message.status` | `groupId` | The group a message was sent to. `null` for a 1:1 message |
| `whatsapp.message.status` | `participant` | `{ waId, userId }` of the member the status is about. `null` for a 1:1 message |

For a group message you sent, you get a status for each member, so one send can produce several `whatsapp.message.status` events. `participant` tells them apart.

In `whatsapp.message.received`, `from` is the member who wrote the message.

## Your main webhook

Your main webhook also receives group activity in the form Meta sends it.\

Messages in a group arrive in the `messages` field with a `group_id`. See [receive webhooks](https://docs.hookmyapp.com/whatsapp/receive-webhooks.md).


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