Introduction
Send WhatsApp messages and manage contacts from your own backend with the OonoBox API.
The OonoBox API lets your own systems do what the OonoBox dashboard does: send WhatsApp template and text messages, manage contacts, and send one-time passcodes — all over your connected WhatsApp number.
Everything you send through the API also shows up in your OonoBox inbox, so your team sees the full conversation.
Base URL
https://api.oonobox.co.zw/apiAll endpoints are versioned under /v1 (e.g. https://api.oonobox.co.zw/api/v1/messages/template).
Authentication
Every request uses an API key sent as a bearer token:
Authorization: Bearer oono_sk_live_xxxxxxxxxxxxxxxxCreate a key in OonoBox under Settings → API keys, choosing the scopes it needs. See Authentication for the full details.
Scopes
A key only works for the scopes you grant it:
| Scope | Lets the key… |
|---|---|
messages.send | send template + text messages |
contacts.read | list contacts |
contacts.write | create / update contacts |
otp.send | send one-time passcodes |
otp.verify | verify one-time passcodes |
What you can do
- Send a template — works any time, even outside the 24-hour window.
- Send a text — for replies inside the 24-hour customer-service window.
- Manage contacts — list and create contacts.
- OTP — send and verify codes over WhatsApp.
New here? Start with the Quickstart — you'll send your first message in a few minutes.
Need help?
Email developers@oonobox.co.zw. We read every message.