Skip to content
DEVELOPER DOCUMENTATION

Vozua SMS API documentation

Send SMS, check your balance and retrieve delivery reports through HTTPS requests. Use JSON request bodies and the active API key from your Vozua account.

POST /api/v1/send
curl -X POST 'https://sms.vozua.app/api/v1/send' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "sender_id": "YOURBRAND",
    "to": ["255712345678"],
    "message": "Your order is ready."
  }'
MADE FOR YOUR DAY-TO-DAY

What you can do with Vozua SMS

HTTPS · JSON · BEARER AUTHENTICATION

Start with three endpoints.

Base URL: https://sms.vozua.app/api/v1. Add Authorization: Bearer YOUR_API_KEY or the X-API-Key header.

METHODENDPOINTPURPOSE
POST/sendSend a message using sender_id, to and message.
GET/balanceRead your account balance, available_units, currency and country_code.
GET/messages/{campaign_id}Read recipient-level status for the campaign_id returned by a send.

Send request fields

sender_id — an approved name on your account
to — array of international-format phone numbers
message — your message text
request_id — optional identifier for safe request retries

Handle the response

A successful submission does not mean delivered. Store campaign_id and check message status. Handle 401 authentication errors, 402 low credit and 422 validation errors before retrying.

GET STARTED WITH VOZUA SMS

Ready to send SMS to your customers?

Create a free account, request your business Sender ID and buy SMS when you are ready to send.

Create your account →Talk to our team