Sending SMS from your app with the API

Authenticate, send a message, receive delivery reports by webhook and handle errors.

Updated 14 September 20262 min read10 views0 found this helpful
On this page

The SMS API lets your website, system or app send one-time PINs, alerts and notifications automatically.

How it works

  1. Get your API key from the SMS dashboard and keep it on your server β€” never in a mobile app or browser code.
  2. Send a request with the recipient, sender ID and message.
  3. Store the message ID that comes back.
  4. Receive delivery reports at a webhook URL on your server.

Example request

curl -X POST "https://YOUR-SMS-API-ENDPOINT/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"254712345678","from":"ACMESHOP","text":"Your code is 482913"}'

Your welcome pack includes the exact endpoint and full API reference.

Good practice

  • Retry only on temporary errors, with a delay.
  • Save delivery reports so support staff can answer "I didn't get the SMS".
  • Use a dedicated sender ID for security codes.
#SMS API#developers#webhooks

Was this article helpful?

Your vote helps us write better guides.

Keep reading

Related articles

Still stuck?

Talk to our support team

Open a ticket

Best for anything technical. Every reply is tracked.

Submit a ticket

Call our Nairobi team

+254 726 872 512 Β· +254 722 917 455

Call now

Message us

Send a question and we'll reply by email or phone.

Contact support
Launch today

Powering Your Online Success!

Domain, hosting, email and SSL from one local team β€” set up in minutes and backed by people you can call.

  • Free SSL
  • Free migration
  • 99.9% uptime
  • 24/7 expert support

Start with your domain

Check availability, then add hosting in the same order.

Prefer to talk? Call +254 726 872 512