Receiving Events

group.join_request

Someone asked to join a group with join approval enabled. Push is best-effort — poll List group join requests as the reliable source.

Event payload

{
  "id": "evt_gjr_5e1c8a3f9b",
  "type": "group.join_request",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:10:30Z",
  "data": {
    "conversation": { "id": "120363041234567890@g.us", "type": "group" },
    "requester": { "id": "8613912345678@lid", "type": "user" },
    "request_method": "invite_link",
    "event": { "kind": "group_join_request" }
  }
}

Notes

data.conversation is the group and data.requester is the user asking to join. request_method is present when the provider exposes how the request was created, such as invite_link.
This push signal is best-effort. For approval UIs, poll List group join requests and use this event as a low-latency hint rather than the only source of truth.