Developer
Webhooks & REST API
Real-time event delivery via webhooks and a full REST API for custom integrations. Build anything on WaSMS.
- Free plan
- No card needed
- No fees per message
Your customersWhatsApp, SMS, email
WWaSMS
Your server
Available webhook events
WaSMS sends a request to your server the moment something happens: a customer messages you, a message is sent or changes status, a lead form is filled in, or a campaign finishes.
- message.received
- message.sent
- message.status
- form.submitted
- campaign.completed
Setup steps
- 1
Create a webhook endpoint
Set up a URL on your server to receive POST requests. Any web server or serverless function works.
- 2
Register in WaSMS
Add your endpoint URL under Developers, Webhooks in your dashboard. Select which events you want to subscribe to.
- 3
Handle incoming events
WaSMS sends a JSON payload to your URL for each event. Verify the signature, process the data, return HTTP 200.
What your server receives
{
"id": "6a0f3c0e-2a55-4d1b-b6a5-0f5a8f0d9c11",
"type": "message.received",
"created_at": "2026-10-11T09:15:02Z",
"organization_id": "b3c1f0a2-5d1e-4f0b-8a43-2f7f3b1e9d77",
"data": {
"message": {
"id": "c0a8012e-7d1b-4c7e-9a52-1f0e2d3c4b5a",
"conversation_id": "9b2d6c1a-3e4f-4a5b-8c7d-6e5f4a3b2c1d",
"direction": "inbound",
"channel": "whatsapp",
"status": "delivered",
"content": "Hi, is my order ready?",
"media_url": null,
"media_type": null,
"sender_name": "Sara Ahmed",
"provider_message_id": "3EB0C767D26A1B2E4F5A",
"created_at": "2026-10-11T09:15:01Z"
},
"contact": { "id": "4f1e2d3c-5b6a-4789-8c0d-1e2f3a4b5c6d", "name": "Sara Ahmed", "phone": "447911123456", "email": null },
"account": { "id": "7a6b5c4d-3e2f-4a1b-9c8d-7e6f5a4b3c2d", "phone": "447900000001" }
}
}Build your integration
No card needed. Upgrade only when you outgrow the free plan.