Home/Docs/Webhooks
Webhooks

Real-time events, pushed to your server

6rsh sends an HTTP POST with a JSON body to your URL the moment something happens — a message is received, sent, delivered, read, or fails.

Available events

EventFires when
message.receivedA customer sends you a WhatsApp message
message.sentAn outbound message is accepted by Meta
message.deliveredThe message reaches the customer's device
message.readThe customer reads the message
message.failedMeta rejects or fails to deliver the message
contact.createdA new contact is created
contact.updatedA contact's details change

Set up an endpoint

  1. Add a webhook in the dashboardIntegrations → Webhooks → Add Webhook. Give it a name, your HTTPS URL, and pick the events you care about.
  2. Send a test eventEvery endpoint has a Test button that fires a sample payload so you can verify your handler before going live.
  3. Respond with 2xx quicklyAcknowledge within a few seconds and process asynchronously. Failed deliveries are retried automatically and everything is visible in the Delivery Logs tab (status, HTTP code, attempt count, response time), where you can also retry manually.

Payload shape

{
  "event": "message.delivered",
  "timestamp": "2026-07-05T10:24:31Z",
  "data": {
    "phone": "+9715XXXXXXXX",
    "wamid": "wamid.XXXX",
    "status": "delivered"
  }
}
Pause any time. Endpoints can be paused and resumed without deleting them, and delivery logs are kept for 30 days.

Connect your store in 5 minutes

Reading the docs is free — sending WhatsApp & Instagram messages just takes a free account. No credit card.

Start Free →

Free forever plan · Setup in 5 minutes · Full Arabic support