Build anything
on top of Wazelo.
Send WhatsApp messages and manage contacts from your own code, and get a webhook when something happens.
Connect Wazelo to your systems.
Create an API key in Settings, send it in the X-API-Key header, and call the REST API to send messages, message up to 100 numbers at once, use templates, manage contacts and check your WhatsApp connection. Webhooks push events like a received message or a finished campaign to your URL, signed so you can verify them and retried if your server is down.
What you can do
Send messages
Send text, media or a template, or the same message to up to 100 numbers in one request.
Contacts API
List, create, read and update contacts, up to 100 per page.
API keys
Create keys with an expiry date, rotate them and revoke them from Settings.
Webhooks
Subscribe to 11 events and receive a signed POST at your URL when they happen.
Signed and retried
HMAC-SHA256 signatures, retries with backoff, a delivery log and a Send test button.
Quick Start
Copy-ready examples in cURL, Node and Python, plus API Logs of your recent calls.
In detail
Endpoints
- POST /messages/send
- POST /messages/send-bulk
- POST /messages/send-template
- GET /messages
- GET /messages/:id
- GET, POST /contacts
- GET, PUT /contacts/:id
- GET, POST /templates
- GET /session/status
Webhook events
- MESSAGE_RECEIVED
- MESSAGE_SENT
- MESSAGE_DELIVERED
- MESSAGE_FAILED
- CONTACT_CREATED
- CONTACT_UPDATED
- CAMPAIGN_COMPLETED
- CAMPAIGN_FAILED
- PAYMENT_SUCCEEDED
- PAYMENT_FAILED
- SUBSCRIPTION_CHANGED
Security and delivery
- X-API-Key header
- Key expiry and rotation
- X-Webhook-Signature
- X-Webhook-Timestamp
- Custom headers
- Up to 10 retries
- Paused after 10 failures
- Up to 25 webhooks
Up and running in minutes
Create a key
Open Settings, Developer API, API Keys and click New API Key. Copy it now, it's shown only once.
Connect WhatsApp
API messages go out from your connected number, so link it by QR first.
Call the API
Send requests to /api/v1/developer with your key in the X-API-Key header.
Add a webhook
In Settings, Webhooks, add your URL, pick events and send a test.
Real requests, real responses.
Questions
Which plans include the API?
Starter, Growth, Pro and Enterprise. The Solo plan doesn't include API access.
How many numbers can a bulk send reach?
Up to 100 recipients per request.
How do I verify a webhook?
Each delivery has an X-Webhook-Signature header: an HMAC-SHA256 of the timestamp and body, made with your webhook secret, which starts with whsec_.
What if my server is down?
Failed deliveries are retried with growing delays, 5 times by default and up to 10. After 10 failures in a row the webhook is paused.