Developer documentation

Build with the InboxIQ API

Get started

Send your first SMS

Go from a new account to a delivered message in four steps.

Steps

  1. Create your account

    Sign up for InboxIQ and verify your email. New accounts get 3 free SMS, so you can test straight away without topping up.

  2. Create an application

    In the dashboard, open Applications and create one for the system you are connecting, for example "Website" or "Mobile app". Copy its application key. You will send it with every request.

  3. Request a sender ID (optional)

    To show your business name instead of the default sender, request an SMS sender ID on the application. Until it is approved, messages go out under the InboxIQ default sender ID.

  4. Send a message

    Call the API with your dashboard username and password, your application key and a phone number you can check:

    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": "Hello from InboxIQ"
    }'

    A successful request returns the message details. The SMS is queued and sent within seconds:

    Response · 200 OK
    {
    "destination": "263771234567",
    "messageText": "Hello from InboxIQ",
    "deliveryStatus": "QUEUED_FOR_SENDING",
    "messageDate": "2026-11-06T14:32:10.512",
    "smsReference": "418273645509213"
    }

What next

  • Learn how authentication works.
  • Send to many numbers at once with bulk SMS.
  • Understand the delivery statuses you will see.
  • Top up SMS credits from Credits & Plans in the dashboard when you are ready to go live.