Want your app to know the instant an SMS arrives or gets delivered? Webhooks send a notification to your server whenever an SMS event happens — no polling needed.
Setting It Up
Go to Webhooks in the sidebar, enter your server's URL (must be HTTPS), choose which events to subscribe to, and save.
Available Events
- Incoming SMS — triggered when someone texts your number
- Delivery Status — triggered when a message status changes (sent, delivered, or failed)
Per-Device Webhooks
You can set different webhook URLs for different devices. A device-level URL overrides the account-level one — useful if different phones feed into different systems.
Example Payloads
Incoming SMS:
{"event": "incoming_sms", "from": "+1555123", "body": "Hi", "device_id": 1}
Delivery Status:
{"event": "delivery_status", "message_id": 123, "status": "delivered"}