← API Reference
Receiving Events

group.updated

Group metadata changed — name, members, or settings.

Payload by change kind

Renamed

{
  "id": "evt_g7a1c4e9b2",
  "type": "group.updated",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:02:11Z",
  "data": {
    "conversation": { "id": "120363041234567890@g.us", "type": "group" },
    "actor": { "id": "8613800138000@s.whatsapp.net", "type": "user" },
    "changes": [
      { "kind": "renamed", "name": "Order Support — VIP" }
    ],
    "event": { "kind": "group_updated" }
  }
}

Members added / removed

{
  "id": "evt_g8b2d5f0c3",
  "type": "group.updated",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:05:40Z",
  "data": {
    "conversation": { "id": "120363041234567890@g.us", "type": "group" },
    "actor": { "id": "8613800138000@s.whatsapp.net", "type": "user" },
    "changes": [
      { "kind": "member_added", "members": ["8613912345678@s.whatsapp.net", "8613998765432@s.whatsapp.net"] },
      { "kind": "member_removed", "members": ["8613900001111@s.whatsapp.net"] }
    ],
    "event": { "kind": "group_updated" }
  }
}

Admin promoted / demoted

{
  "id": "evt_g9c3e6a1d4",
  "type": "group.updated",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:08:15Z",
  "data": {
    "conversation": { "id": "120363041234567890@g.us", "type": "group" },
    "actor": { "id": "8613800138000@s.whatsapp.net", "type": "user" },
    "changes": [
      { "kind": "promoted", "members": ["8613912345678@s.whatsapp.net"] },
      { "kind": "demoted", "members": ["8613900001111@s.whatsapp.net"] }
    ],
    "event": { "kind": "group_updated" }
  }
}

Notes

  • data.conversation is the group, data.actor is who made the change, and data.changes[] is the list of what changed in this snapshot — one event can carry several changes at once (e.g. a rename plus a member_added). event.kind is group_updated.
  • Each entry in changes[] has its own kind: renamed (name), description_changed (description), member_added / member_removed / promoted / demoted (members[] of participant ids), or dissolved. A request to join a group with approval enabled arrives as the separate group.join_request event, not here.