WhatsApp Group Status Update Webhook Examples

Group Suspended

When a WhatsApp group is suspended, you will receive a webhook with the following payload structure:

{
  "id": "evt_group_status_123",
  "type": "whatsapp.group.status_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "tenantId": "tenant-id",
    "wabaId": "123456789012345",
    "field": "group_status_update",
    "type": "group_suspend",
    "status": "suspended",
    "groupId": "[email protected]",
    "webhookTime": "2026-05-13T00:00:00.000Z"
  }
}

Group Suspension Cleared

When a WhatsApp group suspension is cleared, you will receive a webhook with the following payload structure:

{
  "id": "evt_group_status_124",
  "type": "whatsapp.group.status_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "tenantId": "tenant-id",
    "wabaId": "123456789012345",
    "field": "group_status_update",
    "type": "group_suspend_cleared",
    "status": "suspend_cleared",
    "groupId": "[email protected]",
    "webhookTime": "2026-05-13T00:00:00.000Z"
  }
}

Payload Description

type: Always whatsapp.group.status_update for group suspension status events
whatsappGroup: Contains the group suspension status details
- field: Always group_status_update
- type: The status event type, either group_suspend or group_suspend_cleared
- status: The normalized group status, either suspended or suspend_cleared
- groupId: The WhatsApp group ID
- webhookTime: The time at which WhatsApp triggered this webhook