A bulk SMS API built for Kenya
One HTTP call sends an OTP, a receipt or a campaign to every Kenyan network. Delivery reports post back to your webhook with your own tracking ID. High-volume systems can bind over SMPP. Test it with the 10 free SMS every account gets.
Documentation with curl, Node, PHP and Go examples at docs.mobilesasa.com.
send-otp.sh
curl -X POST https://api.mobilesasa.com/v1/send/message \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"senderID":"MOBILESASA","phone":"0712345678",
"message":"Your verification code is 482913"}'{ "status": true, "responseCode": "0200", "message": "Accepted" }
What the API does
Send one message, the same message to many numbers, or a different message to each number in one call. Track every message by your own ID, with delivery reports pushed to your webhook as the network confirms. Manage contacts, groups and the blacklist so opt-outs are respected in every send.
The same token reaches USSD, shortcodes, surveys, WhatsApp, email and phone lookup, so one integration covers every channel you add later.
| SMS sent in a month | KES per SMS |
|---|---|
| Up to 50,000 | 0.60 |
| 50,001 to 500,000 | 0.40 |
| 500,001 to 2,000,000 | 0.35 |
| Above 2,000,000 | 0.25 |
VAT included. Same price on Safaricom, Airtel, Telkom and Equitel. The lower rate applies by itself as your monthly volume grows. No subscription, no setup fee, and units never expire.
Common integrations
One-time PINs and login alerts, M-Pesa payment confirmations, loan and SACCO notifications, school management systems, hospital appointment reminders and ERPs. There is a ready ERPNext integration, and anything that can make an HTTP request can use the API.
Reliability you can see
Messages leave our platform within seconds. Every network's sending and delivery report health is public on status.mobilesasa.com, updated every minute.
Questions people ask
How do I authenticate?
Create an API token in the portal and send it as a Bearer token. Tokens can be limited to the actions they need, such as sending only.
Can each message have its own delivery report URL?
Yes. Set a callback URL for the account, or add callbackUrl to an individual send and that message's report goes there instead.
Will the API change and break my integration?
No. The /v1 and /v2 endpoints are frozen, so what you build keeps working. New features are added alongside them.
How do I verify a delivery report really came from you?
Every callback is signed with your account secret. Check the signature and reject anything that does not match.
Is there an SMPP option?
Yes, for high-volume senders. Ask us for SMPP access and we send you the bind details.
Can I check my balance through the API?
Yes. There are endpoints for balance, delivery reports, contacts and groups, as well as surveys, USSD, WhatsApp and phone lookups.
Developer documentation
- Quickstart
Token, first send and first delivery report.
- Send SMS
Single, bulk and personalised sends.
- Delivery reports
Callbacks, lookups and statuses.
- SMPP
Binds for high-volume traffic.
- Webhook security
Verify every callback.
- USSD API
Drive USSD sessions from your system.
Build your integration this afternoon
Create an account, generate a token and send your first message with the free SMS.