SMS API
Bulk SMS
Send up to 20 personalized SMS messages in one request.
Use bulk sending for small batches of alerts, reminders, receipts, or customer notifications. Each item can have its own recipient, message, sender ID, and client reference.
Endpoint
POST https://api.safravo.co.ke/sms/v1/messages/bulkRequest
{
"count": 2,
"smslist": [
{
"partnerID": "17042",
"apikey": "your-api-key",
"pass_type": "plain",
"clientsmsid": "receipt-1001",
"mobile": "254712345678",
"message": "Your receipt 1001 is ready.",
"shortcode": "YOUR-SENDER-ID"
},
{
"partnerID": "17042",
"apikey": "your-api-key",
"pass_type": "plain",
"clientsmsid": "receipt-1002",
"mobile": "254722345678",
"message": "Your receipt 1002 is ready.",
"shortcode": "YOUR-SENDER-ID"
}
]
}count must equal the number of items in smslist. A single request accepts up to 20 messages.
Response
{
"responses": [
{
"response-code": 200,
"response-description": "Success",
"mobile": "254712345678",
"messageid": 796220792,
"clientsmsid": "receipt-1001",
"networkid": "1"
},
{
"response-code": 200,
"response-description": "Success",
"mobile": "254722345678",
"messageid": 796220793,
"clientsmsid": "receipt-1002",
"networkid": "1"
}
]
}Inspect every item in responses. Bulk requests can contain both successful and rejected messages.
For larger campaigns, use a queue in your application and submit controlled batches. This makes retries, rate limiting, and reconciliation predictable.