Webhooks

Explore all operations and guides for Webhooks.

Webhooks Overview

Stream WhatsApp events to your server in real-time.

Webhooks Endpoints

24 Endpoints
POST
/session.status

Session Status Change

This event is triggered when the session status changes (e.g., from WORKING to STOPPED).

POST
/message

Incoming Message

This event is triggered when a new message is received by your WhatsApp instance.

POST
/message.reaction

Message Reaction

Triggered when a user reacts to a message with an emoji.

POST
/message.any

Any Message

Catch-all event for any message activity in the session.

POST
/message.ack

Message Acknowledgement

Track message delivery and read status (sent, delivered, read).

POST
/message.revoked

Message Revoked

Triggered when a user deletes a message for everyone.

POST
/message.edited

Message Edited

Triggered when a sent message is modified by the user.

POST
/group.v2.join

Group Join (V2)

Triggered when a new member joins or is added to a group.

POST
/group.v2.leave

Group Leave (V2)

Triggered when a member leaves or is removed from a group.

POST
/group.v2.update

Group Updated (V2)

Triggered when group settings like title, description, or icon are changed.

POST
/group.v2.participants

Group Participants Change

Triggered when participants are promoted to admin or demoted.

POST
/presence.update

Presence Updated

Triggered when a contact starts typing, recording audio, or changes their online status.

POST
/poll.vote.failed

Poll Vote Failed

Triggered if a vote on a poll fails to process correctly.

POST
/chat.archive

Chat Archived/Unarchived

Triggered when a chat's archive status changes.

POST
/call.received

Call Received

Triggered when an incoming Voice or Video call is detected.

POST
/call.accepted

Call Accepted

Triggered when a received call is picked up on another device.

POST
/call.rejected

Call Rejected

Triggered when an incoming call is declined.

POST
/label.upsert

Label Created/Updated

Triggered when a WhatsApp Business label is added or modified.

POST
/label.deleted

Label Deleted

Triggered when a label is completely removed from the account.

POST
/label.chat.added

Label Added to Chat

Triggered when a label is assigned to a specific conversation.

POST
/label.chat.deleted

Label Removed from Chat

Triggered when a label is unassigned from a conversation.

POST
/event.response

Event Success Response

Triggered when an asynchronous event completes successfully.

POST
/event.response.failed

Event Failure Response

Triggered when an asynchronous event fails to complete.

POST
/engine.event

Raw Engine Event

Catch-all for low-level system events directly from the WhatsApp engine.