Webhooks

Group Participants Change

Triggered when participants are promoted to admin or demoted.

Best practices

  • Update the 'isAdmin' status for participants in your database.

  • Trigger specific administrative workflows when new admins are appointed.

Participant Role Changes

This event tracks promotions and demotions within a group.

Fields

  • action: Either promote or demote.
  • participants: Array of WhatsApp IDs whose roles were changed.

Expected Responses

Explore all possible responses and outcomes from the server. We have documented each status code with data examples to make success and error handling easier.

Webhook Payload Example
application/json
string *
number *
string *
object *
string *
string *
object *
object *

Example

{
"id": "evt_01...",
"timestamp": 1634567890123,
"session": "default",
"metadata": {
  "user.id": "123",
  "user.email": "email@example.com"
  },
"engine": "WEBJS",
"event": "group.v2.participants",
"payload": {
  "chatId": "1234567890@g.us",
  "action": "promote",
  "participants": {
    "0": "11111111111@c.us"
    }
  },
"me": {
  "id": "11111111111@c.us",
  "lid": "123@lid",
  "pushName": "Instance"
  }
}
Previous TopicGroup Updated (V2)
Next TopicPresence Updated

Command Palette

Search for a command to run...