WhatsApp Group Lifecycle Update Webhook Examples

Group Created

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

{
  "id": "evt_group_lifecycle_123",
  "type": "whatsapp.group.lifecycle_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "tenantId": "tenant-id",
    "wabaId": "123456789012345",
    "displayPhoneNumber": "16315551111",
    "phoneNumberId": "1234567890123456",
    "field": "group_lifecycle_update",
    "type": "group_create",
    "requestId": "REQ_1",
    "status": "created",
    "groupId": "[email protected]",
    "inviteLink": "https://chat.whatsapp.com/AbCdEfGhIjK",
    "subject": "New Purchase Inquiry",
    "description": "Group for purchase inquiries.",
    "joinApprovalMode": "auto_approve",
    "webhookTime": "2026-05-13T00:00:00.000Z",
    "dedupeKey": "123456789012345|REQ_1|group_lifecycle_update|group_create|created"
  }
}

Group Deleted

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

{
  "id": "evt_group_lifecycle_124",
  "type": "whatsapp.group.lifecycle_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "tenantId": "tenant-id",
    "wabaId": "123456789012345",
    "field": "group_lifecycle_update",
    "type": "group_delete",
    "requestId": "REQ_DELETE",
    "status": "deleted",
    "groupId": "[email protected]",
    "webhookTime": "2026-05-13T00:00:00.000Z"
  }
}

Payload Description

type: Always whatsapp.group.lifecycle_update for group lifecycle events
whatsappGroup: Contains the group lifecycle result details
- field: Always group_lifecycle_update
- type: The lifecycle action, such as group_create or group_delete
- requestId: The request ID returned by the asynchronous group API operation
- status: The normalized result status, such as created, deleted, or failed
- groupId: The WhatsApp group ID
- inviteLink: The group invite link, included when group creation succeeds
- dedupeKey: Idempotency key for deduplicating group lifecycle webhook events