Introduction to the Sozuri API
Sozuri is a single API for sending and receiving messages across SMS, WhatsApp, Premium SMS and Airtime in Kenya and across Africa. Integrate once, and we handle the differences between channels, carriers and regulators — so you can focus on the conversation, not the plumbing.
What you can do with Sozuri
Bulk & Transactional SMS
Reach any Safaricom, Airtel or Telkom number with a single API call. One-way alerts, OTPs, marketing — transactional or promotional.
WhatsApp for Business
Send templates, rich media, interactive buttons and conversational replies through the official WhatsApp Business API.
Two-way SMS
Receive replies on your shortcode or dedicated number and route them to your webhook in real time.
Premium SMS & Subscriptions
Monetise content with on-demand premium SMS, subscription services and carrier billing on Safaricom, Airtel and Telkom.
Airtime Topup
Send airtime to any subscriber across Kenyan networks programmatically — perfect for rewards and refunds.
Payments & Collections
Collect via M-Pesa STK Push, C2B, Paybill and Till numbers. Bring your own shortcode or use Sozuri’s.
https://sozuri.net/api/v1/messaging. Other resources (contacts, airtime, payments) live under /api/v1/.
Get up and running in five steps
- Create a Sozuri account. Sign up in a minute — no credit card needed for the sandbox.
- Decide if you need a dedicated number. One-way SMS works out of the box. Two-way SMS, WhatsApp and Premium SMS require an approved sender ID or shortcode — we’ll guide you through the application from your dashboard.
- Create a project. Each project gets its own API key, sender ID, callback URL and credit balance, so you can keep apps isolated.
- Test in the sandbox. Add up to five test numbers and send real traffic without burning credits. See the FAQ if a test message doesn’t arrive.
- Go live. Top up credits from your dashboard and your sandbox project flips to production — no code changes required.
Supported message types
| Message type | SMS | |
|---|---|---|
| Plain text | Yes | Yes |
| Rich text (bold, italic, lists) | — | Yes |
| Media (image, video, audio, document) | — | Yes |
| Templates | Yes | Yes |
| URL preview | Yes | Yes |
| Interactive buttons & lists | — | Yes |
Where to go next
Jump straight to the code samples for ready-made requests in PHP, Node, Python, Ruby, Java, C# and cURL. Or import our Postman collection from the sidebar to try every endpoint without writing a line of code.
Use cases
A few of the everyday problems Sozuri solves for teams across Kenya and Africa.
OTP & two-factor authentication
Deliver one-time passcodes in seconds to keep logins, signups and payments secure.
It expires in 5 minutes. 10:24
Order updates on WhatsApp
Notify customers as their order is confirmed, dispatched and delivered — right in their WhatsApp inbox.
Marketing campaigns at scale
Blast a sender-ID campaign to thousands of contacts and track delivery, opens and replies in one dashboard.
M-Pesa Paybill & STK Push
Trigger an STK prompt on a customer’s phone, receive the callback, and complete checkout in seconds.
Build your first integration today.
Create a project, drop in your API key, and send a real SMS or WhatsApp message in under five minutes.