MobileSasaDocs
Open portal

Quickstart

From nothing to a delivered SMS in about five minutes. One portal visit to get credentials, then everything else happens over the API.

1. Create an account and get a token

  1. Register at app.mobilesasa.com (free — no card needed).
  2. Go to Settings → API Tokens and create a token. Copy it immediately — it is shown once.
  3. Note your approved sender ID (Sender IDs page). New accounts can send with the shared MOBILESASA sender while their branded name is being registered.

Keep tokens server-side

A token is a password. Never embed it in a mobile app, browser JavaScript, or a public repository — calls should always come from your backend.

2. Send your first message

curl -X POST https://api.mobilesasa.com/v1/send/message \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "senderID": "MOBILESASA",
    "phone": "0712345678",
    "message": "Hello! Your MobileSasa integration works."
  }'

3. Read the response

Success
{
  "status": true,
  "responseCode": "0200",
  "message": "Accepted for delivery"
}

status tells you whether the request was accepted; responseCode is a stable machine-readable code (full list in Responses & errors). Delivery to the handset is asynchronous — track it with delivery reports.

4. Go further

Phone number formats

All of these are accepted and normalised to E.164 for you: 0712345678, 254712345678, +254712345678. Invalid numbers are rejected with a validation error rather than billed and dropped.