Zuno SMS
ZUNO SMS

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" }