Webhooks
SMS payloads & headers
Inspect documented SMS event bodies and delivery headers.
sms_sent request body
{
"id": "sms_message_41_sent",
"type": "sms_sent",
"created_at": "2026-08-14T10:15:01+00:00",
"data": {
"message": {
"message_id": "msg_api_example_0",
"from": "IllyVoIP",
"to": "+12025550125",
"message": "Hello from API",
"status": "sent",
"status_label": "Sent",
"status_message": "",
"cost": 0.05,
"country": "US",
"created_at": "2026-08-14 10:15:00",
"sent_at": "2026-08-14 10:15:01",
"delivered_at": "",
"refunded": false,
"refunded_amount": 0,
"refunded_at": "",
"updated_at": "2026-08-14 10:15:01"
}
}
}sms_delivered request body
{
"id": "sms_message_41_delivered",
"type": "sms_delivered",
"created_at": "2026-08-14T10:15:05+00:00",
"data": {
"message": {
"message_id": "msg_api_example_0",
"from": "IllyVoIP",
"to": "+12025550125",
"message": "Hello from API",
"status": "delivered",
"status_label": "Delivered",
"status_message": "",
"cost": 0.05,
"country": "US",
"created_at": "2026-08-14 10:15:00",
"sent_at": "2026-08-14 10:15:01",
"delivered_at": "2026-08-14 10:15:05",
"refunded": false,
"refunded_amount": 0,
"refunded_at": "",
"updated_at": "2026-08-14 10:15:05"
}
}
}sms_failed request body
{
"id": "sms_message_41_failed",
"type": "sms_failed",
"created_at": "2026-08-14T10:16:00+00:00",
"data": {
"message": {
"message_id": "msg_api_example_0",
"from": "IllyVoIP",
"to": "+12025550125",
"message": "Hello from API",
"status": "refunded",
"status_label": "Refunded",
"status_message": "The SMS charge was refunded.",
"cost": 0.05,
"country": "US",
"created_at": "2026-08-14 10:15:00",
"sent_at": "2026-08-14 10:15:01",
"delivered_at": "",
"refunded": true,
"refunded_amount": 0.05,
"refunded_at": "2026-08-14 10:16:00",
"updated_at": "2026-08-14 10:16:00"
}
}
}sms_delivered headers
Content-Type: application/json
User-Agent: IllyVoIP-Webhooks/1.0
Illyvoip-Signature: t=1776334501,v1=<hmac_sha256>
Illyvoip-Event: sms_delivered
Illyvoip-Delivery: 701