Airtime VTU, Share & Sell
Data Gifting, SME, Transfer, Corporate, Talk More
Transaction
Webhooks
Send SMS
post
/sms
Send SMS to one or more Nigerian numbers.
Pricing: units = ceil(message_length / 160) x number_of_recipients. You are charged per unit (a segment is 160 characters). For example, a 200-character message (2 segments) sent to 3 recipients costs 6 units.
Pricing: units = ceil(message_length / 160) x number_of_recipients. You are charged per unit (a segment is 160 characters). For example, a 200-character message (2 segments) sent to 3 recipients costs 6 units.
Body
{
"request_ref": "Request Ref",
"recipients": "2348012345678,2348098765432",
"message": "Your message",
"sender_id": "Approved Sender ID",
"webhook_url": "Webhook URL",
"pin": "Your pin"
}Parameters
| recipients | Nigerian MSISDN(s). A comma-separated string or an array, e.g. "2348012345678,2348098765432". Accepts 234XXXXXXXXXX or 0XXXXXXXXXX formats. Maximum 1000 recipients per request. |
| message | The SMS body. String, maximum 1000 characters. |
| sender_id | The sender ID that appears to the recipient. String, maximum 20 characters. Must be an approved sender ID on your account. |
| request_ref | Your unique Request Ref (Optional). String, maximum 50 characters. Used as an idempotency key so a retried request is not charged twice. |
| webhook_url | Optional. If not explicitly provided, the system will automatically utilize the webhook URL specified in your developer keys. |
| pin | Your transaction pin (4 digits). |
Sample Response
{
"status": "ok",
"message": "Request successfully",
"data": {
"transaction": {
"id": 128,
"user_id": 1,
"user_product_id": 21,
"user_variation_id": 44,
"reference": "b1d2c3e4-76da-4d12-bccc-90d040704dc8",
"request_ref": "pZxmX4qjpOLRCx8d6jRc",
"type": "MTN SMS",
"details": "MTN SMS sent to 2 recipient(s)",
"amount": "12.00",
"status": "successful",
"request_data": {
"recipients": "2348012345678,2348098765432",
"message": "Hello from AutoSync",
"sender_id": "AutoSync",
"request_ref": "pZxmX4qjpOLRCx8d6jRc"
},
"created_at": "2026-05-21T08:14:13.000000Z",
"updated_at": "2026-05-21T08:14:29.000000Z"
}
}
}{
"status": "error",
"message": "Invalid or empty recipients list. Use NG numbers like 234XXXXXXXXXX or 0XXXXXXXXXX."
}