Send request fields
sender_id — an approved name on your accountto — array of international-format phone numbersmessage — your message textrequest_id — optional identifier for safe request retries
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.
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."
}'const response = await fetch(
'https://sms.vozua.app/api/v1/send', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
sender_id: 'YOURBRAND',
to: ['255712345678'],
message: 'Your order is ready.'
})
}
);import requests
response = requests.post(
'https://sms.vozua.app/api/v1/send',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'sender_id': 'YOURBRAND',
'to': ['255712345678'],
'message': 'Your order is ready.'
}
)$request = curl_init(
'https://sms.vozua.app/api/v1/send'
);
curl_setopt_array($request, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json'
],
CURLOPT_POSTFIELDS => json_encode([
'sender_id' => 'YOURBRAND',
'to' => ['255712345678'],
'message' => 'Your order is ready.'
])
]);Generate and manage credentials in your account. Never expose them in a mobile application or public website code.
Select saved contacts or groups, paste phone numbers or upload a CSV file. Check the recipient list before sending.
See which SMS reached the recipient, which are still waiting for confirmation and which failed. Open the report for each send to check individual numbers.
Base URL: https://sms.vozua.app/api/v1. Add Authorization: Bearer YOUR_API_KEY or the X-API-Key header.
| METHOD | ENDPOINT | PURPOSE |
|---|---|---|
| POST | /send | Send a message using sender_id, to and message. |
| GET | /balance | Read 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. |
sender_id — an approved name on your accountto — array of international-format phone numbersmessage — your message textrequest_id — optional identifier for safe request retries
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.
Create a free account, request your business Sender ID and buy SMS when you are ready to send.