Send SMS
Send an SMS to one or more recipients using your API key. Credits are deducted from your active package when the message is accepted.
POST
https://zunosms.com/api/send-sms
Authentication
Every request must include an active API key in the X-API-Key header.
X-API-Key: your_api_key_here
Note: API keys are created from your dashboard under API Keys.
Request body
| Field | Description |
|---|---|
| phonerequired |
Comma-separated recipient phone numbers, or an array.
Accepts
0700000000, 256700000000, or +256700000000. Duplicates are removed. |
| messagerequired | The message text. Max 1000 characters. |
Billing
Messages are billed per part, and each part counts as one credit per recipient.
A message of up to 160 characters is billed as 1 part. Anything longer is split and billed as 2 or more parts — a message of 161 characters is billed as 2 parts.
Formula:
credits_used = recipient_count × parts.
Credits are only deducted after the message is accepted. If it fails, no credits are consumed.
Example
curl -X POST https://zunosms.com/api/send-sms \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key_here" \
-d '{
"phone": "0700000000,0700000001",
"message": "Hello from Zuno SMS"
}'
Success response
Returns the response in this shape:
{
"reference": 1760385123456789,
"status": "success",
"message": "SMS sent successfully",
"code": 200,
"successful": 1,
"failed": 0,
"credits_used": 1,
"message_parts": 1
}
Error responses
| Status | When |
|---|---|
| 400 | Missing fields, invalid phone numbers, empty or oversized message, no active package, or insufficient credits. |
| 401 | API key missing or invalid. |
| 403 | Account is not active. |
| 500 | Internal error on our side. |
Error bodies follow this shape:
{
"error": "Insufficient credits in active package. Need 2, have 0"
}