Endpoint
Headers
| Header | Value |
|---|---|
Accept | application/json |
Authorization | Bearer {API_TOKEN} |
Content-Type | application/json |
Body parameters
Recipient phone number. Accepts local format (
08140363541), country code (2348140363541), or + prefix (+2348140363541).SMS text content. Maximum 3 pages, approximately 480 characters.
Registered Sender ID.
Sender ID route. Accepted values:
transactional or promotional.Public HTTPS URL that receives delivery updates.
Saved contact ID. Use instead of
to.Contact group ID. Use instead of
to.URL parameters
This endpoint also supports URL-based sending withapi_token, to, message, and sender as query parameters.
Response fields
"success" when the message is accepted.Delivery state, such as
"delivered", "pending", or "failed".Unique message ID. Use it with Message Status.
Sender ID used for delivery.
Message text.
Normalized recipient phone number.
Prior delivery attempts for the message.
Credits deducted for this message.
Error responses
| Status | Meaning |
|---|---|
400 | Missing or invalid request fields |
400 | Insufficient credit |