SimpliSend API

Send SMS, check delivery status, and manage your account programmatically. This site documents both API surfaces SimpliSend exposes:

Public API

For custom integrations - send SMS from your own app using a simple X-API-Key. Start here if you want to send messages programmatically.

Platform API

The full REST surface behind the SimpliSend account dashboard - auth, contacts, campaigns, billing, team management, and more. JWT-authenticated.

Base URL

All endpoints, on both surfaces, are rooted at:

https://app.simplisend.co.za/api/v1

Test it in Postman

Every endpoint on this site, Public and Platform, is in one ready-to-run Postman collection - variables for the base URL and your API key, and a Login request that saves its access/refresh tokens for every other Platform API request automatically.

Download Postman collection

In Postman: Import → File → the downloaded .json. Then set the apiKey collection variable, or run Platform API → Auth → Login to populate accessToken for the JWT-authenticated requests.

Quickstart: send an SMS

Once you have an API key (see Authentication), sending a message is one request:

curl

curl -X POST https://app.simplisend.co.za/api/v1/public/sms/send \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+27821234567",
    "body": "Hi from SimpliSend!"
  }'

See the full walkthrough in the Send an SMS reference.

Two ways to authenticate

X-API-Key - scoped to one account, for the Public API. This is what most integrations should use. See Authentication.
Bearer JWT - a user session token from /auth/login or /auth/register, used by the Platform API (and by the SimpliSend apps themselves).

No API key yet?

API keys are issued from inside your SimpliSend account (Settings → API Keys). If you don't have an account yet, register for free - the Free plan includes enough SMS credit to test an integration end to end.