Webhooks
Receive real-time delivery events.
Configure webhooks to get SMS and voice status updates instantly.
Webhook basics
- HTTPS endpoints only
- JSON payloads with event metadata
- Retry on failure
- Signature verification recommended
Event types
Subscribe to delivery updates and call statuses.
sms.delivered
Message delivered successfully.
sms.failed
Delivery failed or rejected.
voice.completed
Call completed with duration and cost.
Example payload
{
"event": "sms.delivered",
"message_id": "msg_123",
"to": "12025550123",
"status": "delivered",
"timestamp": "2026-01-21T10:22:31Z"
}Best practices
- Verify signatures for every request
- Return 200 quickly to stop retries
- Idempotent processing for duplicates
- Monitor webhook health