Skip to main content
These events notify you about group activity: participants who join, leave, are promoted or demoted, and the join request flow. All of them follow the common envelope — the specific content is in data.

Participants: join / leave / promote / demote

Four events cover participant changes and share the same data format:
string
required
JID of the group (@g.us).
string
Group name.
string[]
required
List of JIDs of the participants affected by the action.
number
required
Time of the event in seconds (epoch).
string
JID of who performed the action (e.g. the admin who added/promoted).

Join requests

When a group requires approval to join, three events cover the request lifecycle:
There is no rejected request event — the backend only emits the variants above. Use .revoked to detect when a request is cancelled.

group_participants.join-request

string
required
JID of the group (@g.us).
string
Group name.
string
required
JID of who requested to join.
string
Name of who requested to join.
number
required
Time of the request in seconds (epoch).

group_participants.join-request.revoked

Same data format as group_participants.join-request. Indicates that the request was cancelled by the requester themselves.

group_participants.join-request.approved

Fired when an admin approves the request. Includes the additional approved_by field.
string
required
JID of the group (@g.us).
string
Group name.
string
required
JID of who requested to join.
string
Name of who requested to join.
string
JID of the admin who approved the request.
number
required
Time of the approval in seconds (epoch).