Send an SMS
Send one message to one phone number. Use it for one-time passwords, alerts and notifications.
/api/v1/send-smsRequest
Send a JSON body with the number and the message. Authenticate as described in Authentication.
destinationstringRequiredThe phone number to send to. Use an Econet, NetOne or Telecel number, digits only, with no spaces, for example 263771234567.
messageTextstringRequiredThe text of the message. Emoji are not allowed. Up to 160 characters are sent as a single SMS.
curl -X POST https://api.inboxiq.co.zw/api/v1/send-sms \ -H "Authorization: Basic $(echo -n 'username:password' | base64)" \ -H "key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "destination": "263771234567", "messageText": "Your login code is 482915. It expires in 5 minutes." }'Phone numbers
InboxIQ accepts Zimbabwean mobile numbers on all three networks, in local or international form:
| Network | Prefixes | Example |
|---|---|---|
| Econet | 077078079 | 263771234567 |
| NetOne | 071 | 263712345678 |
| Telecel | 073 | 263731234567 |
The international form 2637… is recommended. Numbers can also start with +263, 00263 or 07. Remove spaces and dashes before sending.
Response
A 200 OK response means the message was accepted and queued. Delivery happens a few seconds later.
{ "destination": "263771234567", "messageText": "Your login code is 482915. It expires in 5 minutes.", "deliveryStatus": "QUEUED_FOR_SENDING", "messageDate": "2026-11-06T14:32:10.512", "smsReference": "418273645509213"}destinationstringThe number the message was sent to.
messageTextstringThe text that was sent.
deliveryStatusstringThe current status of the message. New messages start as QUEUED_FOR_SENDING.
messageDatestringWhen InboxIQ accepted the message, in ISO 8601 format.
smsReferencestringInboxIQ’s unique reference for the message. Store it to match the message to records in your system and the dashboard.
Sender ID
The message is sent under your application's approved SMS sender ID, or the InboxIQ default sender ID if you have not had one approved. You cannot choose a different sender per request.
Message length
- A single SMS holds up to 160 characters, including spaces and punctuation.
- Longer messages are delivered in several parts and joined on the phone.
- Emoji are rejected with a
400error. Use plain text.
Credits
Each SMS uses one credit from your account. If there is not enough credit the request fails with 400 Bad Request and nothing is sent:
{ "timestamp": "2026-11-06T12:32:10.512Z", "status": 400, "error": [ "You do not have enough credit to send 1 sms(s), please contact your account manager to recharge" ], "path": "uri=/api/v1/send-sms", "message": "You do not have enough credit to send 1 sms(s), please contact your account manager to recharge"}