Wawp WhatsApp API
HomePricing
HomePricing
WhatsApp
API Status
  1. 🪝 Webhooks
  • ⛓️‍💥 Session - instances
    • Wawp’s Session Lifecycle
    • Create new Session
      POST
    • Start Session
      POST
    • Stop Session
      POST
    • Restart Session
      POST
    • Delete Session
      DELETE
    • Logout Session
      POST
    • Get Session info
      GET
    • About WhatsApp Data
      GET
  • 📲 Authentication - Login
    • About login authentication
    • GET QR raw
      GET
    • GET QR image
      GET
    • Request code
      POST
    • Get a live screenshot
      GET
  • 📤 Send Messages
    • Send Messages
    • Send Text
    • Send Image
    • Send PDF
    • Send Voice
    • Send video
    • Send Link Preview
    • Send Location
    • Send poll
    • Send Contact Vcard
    • Mark message(s) as seen
    • Start typing
    • Stop typing
    • Reaction
    • Star/unstar a message
  • ℹ️ Whatsapp Profile info
    • WhatsApp Profile Info
    • Get profile
    • Set display‑name
    • Set “About” status
    • Upload Whatsapp picture
    • Delete profile picture
  • 📢 Channels Control
    • Get list of know channels
    • Create a new channel.
    • Get channel info
    • Delete channel
    • Preview channel messages
    • Follow a channel
    • Unfollow a channel
    • Mute a channel
    • Unmute a channel
    • Search channels — by view
    • Search channels — by text
    • Search metadata — views / countries / categories
  • 🟢 Presence information
    • Presence API
    • Set session presence
    • Get the presence for the chat id
  • 🔊 24 Hour Status
    • Text status
    • Image status
    • Voice status
    • Video status
    • Delete status
  • 💬 Chats
    • Chats list & overview
    • chats overview
    • chats overview
    • Delete the chat
    • Get chat picture
    • Get messages in the chat.
    • Clear all messages from the chat.
    • Mark unread messages as read.
    • Get message by id
    • Delete a message
    • Edit a text message
    • Pin a message
    • Unpin a message
    • Archive the chat
    • Unarchive the chat
    • Mark chat as unread
  • 🪪 Contacts
    • Get all contacts
    • Get basic contact info
    • Check phone is on WhatsApp
    • Get contact “about”
    • Get contact profile picture (24h cache; add refresh=true to bust)
    • Block contact
    • Unblock contact
    • Create/Update contact on phone address book
    • Get all known lids to phone number mapping
    • Get the number of known lids
  • 👥 Groups
    • Get All List groups
    • Create a group
    • Join info (by code or URL)
    • Join group
    • Get the number of groups
    • Refresh groups from the server
    • Get the group
    • Delete the group
    • Leave the group
    • Get group picture
    • Set group picture
    • Delete group picture
    • Updates the group description
    • Updates the group subject
    • Updates the group "info admin only" settings
    • Update settings - who can send messages
    • Get settings - who can send messages
    • Set messages admin only
    • Get the invite code for the group
    • Invalidates the current group invite code and generates a new one
    • Get participants
    • Add participants
    • Remove participants
    • Promote participants to admin users
    • Demotes participants to regular users
  • 🏷️ Labels
    • Labels API
    • GET all labels
    • Create label
    • Update label
    • DELETE label
    • labels for a chat
    • Save labels for a chat
    • Chats with a label
  • 🪝 Webhooks
    • Wawp’s Webhook API
    • session.status
      POST
    • message
      POST
    • message.reaction
      POST
    • message.any
      POST
    • message.ack
      POST
    • message.revoked
      POST
    • message.edited
      POST
    • group.v2.join
      POST
    • group.v2.leave
      POST
    • group.v2.update
      POST
    • group.v2.participants
      POST
    • presence.update
      POST
    • poll.vote.failed
      POST
    • chat.archive
      POST
    • call.received
      POST
    • call.accepted
      POST
    • call.rejected
      POST
    • label.upsert
      POST
    • label.deleted
      POST
    • label.chat.added
      POST
    • label.chat.deleted
      POST
    • event.response
      POST
    • event.response.failed
      POST
    • engine.event
      POST
  1. 🪝 Webhooks

Wawp’s Webhook API

Wawp’s Webhook API makes WhatsApp events stream in real-time to your automation flows — so you can capture, process, and react instantly with n8n, Zapier, or any custom server endpoint.
By forwarding messages, reactions, status updates, and more, webhooks turn Wawp into a live event source for your workflows.
webhook.png
Before you can receive events, you must:
1.
Set up a webhook listener (for example in n8n, Zapier, or your own Node.js/PHP server).
2.
Tell Wawp where to send events by configuring the webhook in your Wawp account.

By exposing consistent event payloads, Wawp eliminates polling and provides a clean, scalable integration path. Developers can filter which events they need, and operators benefit from retry policies that guarantee delivery even if their server is temporarily offline.
Documenting webhook use on https://docs.wawp.net with examples, failure retries, and event types ensures fast adoption and fewer integration issues.

⚙️ Configure the Webhook in Your Wawp Account#

Next, you need to tell your Wawp account where to send the event data:
1.
Log into your Wawp dashboard.
2.
Go to the Connected Numbers area.
3.
Click the Webhook button on your number’s instance card.
4.
In the popup, click Add New Webhook.
5.
Fill in the details:
Webhook URL: Paste the Production URL from your Wawp Trigger node in n8n (or your Zapier/custom server endpoint).
Retry Policy: Choose how often Wawp retries on failure (e.g., every 5 seconds).
Events to Receive: Select event types (e.g., messages, reactions) to avoid unnecessary traffic.
⚠️ The webhook URL must be publicly accessible. Localhost links won’t work — use n8n Cloud or a self-hosted instance with a domain.

📦 Example Webhook Payload#

{
  "instance_id": "123456789",
  "event": "message",
  "data": {
    "from": "200000000001@c.us",
    "to": "200000000002@c.us",
    "body": "Hello, world!",
    "timestamp": 1722170400
  }
}
Modified at 2025-09-29 02:09:35
Previous
Chats with a label
Next
session.status
Built with