Groups

WhatsApp Cloud API Webhooks for Groups

The groups array contains all groups that were sent to the webhook URL. Sent on event "groups.post".

The groups participants event array contains all groups participants event that were sent to the webhook URL. Sent on event "groups.put"

The groups updates array contains all groups updates that were sent to the webhook URL. Sent on event "groups.patch"

You can find more details about all parameters and their types in the WebHook documentation. We mentioned more about the events here: Mode setting

New group

You have been added to a group, or a group has been created with you. Use the groups.post setting to get this webhook.

{
  "groups": [
    {
      "id": "[email protected]",
      "name": "Group name! 😃",
      "type": "group",
      "timestamp": 1713791253,
      "participants": [
        {
          "id": "61371989950",
          "rank": "member"
        },
        {
          "id": "919984351847",
          "rank": "creator"
        }
      ],
      "name_at": 1713791253,
      "created_at": 1713791253,
      "created_by": "919984351847"
    }
  ],
  "event": {
    "type": "groups",
    "event": "post"
  },
  "channel_id": "MANTIS-M72HC"
}

---

New message in the group

Use the messages.post setting to get this webhook.

{
  "messages": [
    {
      "id": ".juaBlBX6cgpT8UKLNnVEw-kh8Bq53B6TdEoQ-E8JdK1c",
      "from_me": false,
      "type": "text",
      "chat_id": "[email protected]",
      "timestamp": 1713791337,
      "source": "mobile",
      "text": {
        "body": "Hey, what's up"
      },
      "from": "919984351847",
      "from_name": "Gerald"
    }
  ],
  "event": {
    "type": "messages",
    "event": "post"
  },
  "channel_id": "MANTIS-M72HC"
}

---

A new member has been added

Use the groups.put setting to get this webhook.

{
  "groups_participants": [
    {
      "group_id": "[email protected]",
      "participants": [
        "61280155346"
      ],
      "action": "add"
    }
  ],
  "event": {
    "type": "groups",
    "event": "put"
  },
  "channel_id": "MANTIS-M72HC"
}

Participant removed

Use the groups.put setting to get this webhook.

{
  "groups_participants": [
    {
      "group_id": "[email protected]",
      "participants": [
        "61280155346"
      ],
      "action": "remove"
    }
  ],
  "event": {
    "type": "groups",
    "event": "put"
  },
  "channel_id": "MANTIS-M72HC"
}

Participant became an admin

Use the groups.put setting to get this webhook.

{
  "groups_participants": [
    {
      "group_id": "[email protected]",
      "participants": [
        "61371989950"
      ],
      "action": "promote"
    }
  ],
  "event": {
    "type": "groups",
    "event": "put"
  },
  "channel_id": "MANTIS-M72HC"
}

The participant is no longer an administrator

Use the groups.put setting to get this webhook.

{
  "groups_participants": [
    {
      "group_id": "[email protected]",
      "participants": [
        "61371989950"
      ],
      "action": "demote"
    }
  ],
  "event": {
    "type": "groups",
    "event": "put"
  },
  "channel_id": "MANTIS-M72HC"
}

New request to join a group

Use the groups.put setting to get this webhook.

{
  "groups_participants": [
    {
      "group_id": "[email protected]",
      "participants": [
        "61371989850"
      ],
      "action": "request"
    }
  ],
  "event": {
    "type": "groups",
    "event": "put"
  },
  "channel_id": "MANTIS-M72HC"
}

Group name changed

Use the groups.patch setting to get this webhook.

{
  "groups_updates": [
    {
      "before_update": {
        "id": "[email protected]",
        "name": "Our journey ⛰️",
        "type": "group",
        "participants": [
          {
            "id": "61371989950",
            "rank": "member"
          },
          {
            "id": "919984351847",
            "rank": "creator"
          }
        ],
        "name_at": 1747661405,
        "created_at": 1743410397,
        "created_by": "919984351847",
        "adminAddMemberMode": true
      },
      "after_update": {
        "id": "[email protected]",
        "name": "Good trip ⛰️🏔️",
        "type": "group",
        "participants": [
          {
            "id": "61371989950",
            "rank": "member"
          },
          {
            "id": "919984351847",
            "rank": "creator"
          }
        ],
        "name_at": 1747661405,
        "created_at": 1743410397,
        "created_by": "919984351847",
        "adminAddMemberMode": true
      },
      "changes": [
        "name"
      ]
    }
  ],
  "event": {
    "type": "groups",
    "event": "patch"
  },
  "channel_id": "MANTIS-M72HC"
}

Changed group profile picture

Use the groups.patch setting to get this webhook.

{
  "groups_updates": [
    {
      "before_update": {
        "id": "[email protected]",
        "name": "Our journey ⛰️",
        "type": "group",
        "timestamp": 1747391325,
        "chat_pic": "changed",
        "not_spam": true,
        "last_message": {
          "id": "EFgJZBk-kusBq53fm7NK5g-E8JdK1c",
          "type": "system",
          "subtype": "group_change_icon",
          "chat_id": "[email protected]",
          "from": "919984351847",
          "from_me": false,
          "source": "system",
          "timestamp": 1747661806
        },
        "participants": [
          {
            "id": "61371989950",
            "rank": "member"
          },
          {
            "id": "919984351847",
            "rank": "creator"
          }
        ],
        "name_at": 1747661405,
        "created_at": 1743410397,
        "created_by": "919984351847",
        "adminAddMemberMode": true
      },
      "after_update": {
        "id": "[email protected]",
        "name": "Our journey ⛰️",
        "type": "group",
        "timestamp": 1747391325,
        "chat_pic": "https://pps.whatsapp.net/v/t62.24694-24/491878509_1329198295045131_8243456031832458554_n.jpg?stp=dst-jpg_s96x96_tt6&ccb=11-4&oh=01_Q5Aa1gEq-WZYAgjAZMZd6UEZFN30lEsxoha3JZH0bs07_p7F7Q&oe=683838BA&_nc_sid=5e03e0&_nc_cat=111",
        "chat_pic_full": "https://pps.whatsapp.net/v/t62.24694-24/491878509_1329198295045131_8243456031832458554_n.jpg?ccb=11-4&oh=01_Q5Aa1gEQcMhEWHOOb7XuktZhPH4l-uN1CcLGU46zZsWMt90VGQ&oe=683838BA&_nc_sid=5e03e0&_nc_cat=111",
        "not_spam": true,
        "last_message": {
          "id": "EFgJZBk-kusBq53fm7NK5g-E8JdK1c",
          "type": "system",
          "subtype": "group_change_icon",
          "chat_id": "[email protected]",
          "from": "919984351847",
          "from_me": false,
          "source": "system",
          "timestamp": 1747661806
        },
        "participants": [
          {
            "id": "61371989950",
            "rank": "member"
          },
          {
            "id": "919984351847",
            "rank": "creator"
          }
        ],
        "name_at": 1747661405,
        "created_at": 1743410397,
        "created_by": "919984351847",
        "adminAddMemberMode": true
      },
      "changes": [
        "chat_pic",
        "chat_pic_full"
      ]
    }
  ],
  "event": {
    "type": "groups",
    "event": "patch"
  },
  "channel_id": "MANTIS-M72HC"
}

Changing a participant's number

Technical note: Currently, if a member in your group changes their phone number, the system will trigger the same event as if a new member was added to the group. Please keep this in mind. We will update this page if in the future we can distinguish between new members and number updates for existing members.