Callback & Webhooks
Register a callback URL to receive SMS delivery status updates as they happen, instead of polling.
Send Callback URL
POST
/callbackRegisters your callback (webhook) URL for SMS delivery status updates.
| Field | Example | Description |
|---|---|---|
| token* | xxxxxxxxxxxx | Your API key. |
| url* | xxxxxxxx | Your callback URL. |
Webhook delivery status
The delivery webhook sends the final SMS delivery status to your callback URL in the status field. Use the status, code, and description fields to determine the final delivery result.
| Status | Code | Description |
|---|---|---|
| DELIVRD | 000 | Recipient has received the message successfully |
| UNDELIVRD | 99 | Recipient is on DND |
| UNDELIVRD | 100 | Message could not be delivered |
| EXPIRED | 101 | Message delivery attempt expired |
| REJECTD | 102 | Message was rejected |
| UNKNOWN | 150 | Message was sent, but the delivery status from the gateway/operator is not recognized |
Example response — 200 OK
{
"status": "DELIVRD",
"api_reference": "CUSTOMER_REF_12345",
"data": {
"code": "000",
"cost": "1.50",
"recipient": "2348012345678",
"time": "2026-06-09 12:30:45",
"network": "MTN",
"country": "Nigeria",
"description": "Recipient has received the message successfully"
},
"vendor": "Kudisms"
}Updated at, Sunday, July 19, 2026