Developer documentation

Build with the InboxIQ API

SMS

Send an SMS

Send one message to one phone number. Use it for one-time passwords, alerts and notifications.

POST/api/v1/send-sms

Request

Send a JSON body with the number and the message. Authenticate as described in Authentication.

destinationstringRequired

The phone number to send to. Use an Econet, NetOne or Telecel number, digits only, with no spaces, for example 263771234567.

messageTextstringRequired

The 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:

NetworkPrefixesExample
Econet077078079263771234567
NetOne071263712345678
Telecel073263731234567

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.

Response · 200 OK
{
"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"
}
destinationstring

The number the message was sent to.

messageTextstring

The text that was sent.

deliveryStatusstring

The current status of the message. New messages start as QUEUED_FOR_SENDING.

messageDatestring

When InboxIQ accepted the message, in ISO 8601 format.

smsReferencestring

InboxIQ’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 400 error. 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:

Not enough credit · 400
{
"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"
}