APIReference
Webhooks & Delivery Reports
Register a callback URL to receive a delivery report as each message moves through its lifecycle.
POSTyour callback_url
This reference documents the intended request/response shape. Exact field names are confirmed with our platform partner before this endpoint goes live.
01Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| message_id | string | Required | The ID returned when the message was sent. |
| status | "queued" | "sent" | "delivered" | "failed" | Required | Current delivery state. |
| channel | string | Required | The channel this report is for. |
| timestamp | string | Required | ISO 8601 timestamp of the status change. |
02Request
# We POST to the callback_url on your account or per-message.# Retries: up to 3 attempts with exponential backoff# on a non-2xx response.03Response
{ "message_id": "msg_9F2k", "status": "delivered", "channel": "sms", "timestamp": "2026-09-05T10:22:31Z"}Need a hand integrating this?
Our integration team reviews your first call for free.