Quickstart

Five steps from nothing to a delivered SMS. Budget five minutes.

1. Sign up

Create an account at sms.xash.network/register. You need a name, a business name, a Zimbabwean or South African phone number, and a password. The phone number is your login.

2. Verify your phone

We send a 6-digit code to the number you registered (and to your email, if you gave one). Enter it and you are in.

3. Load US$5

Open Top up in the dashboard. Pay with EcoCash, OMari, InnBucks, USDT (BEP20), or a South African voucher (1Voucher, OTT, Blu). US$5 is the minimum and buys 125 messages to Zimbabwe or 250 to South Africa.

4. Create an API key

Open API keys, click Create key, and copy the key. It is shown once.

5. Send

curl -X POST https://sms.xash.network/api/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "sms",
    "to": "+263771234567",
    "body": "Your verification code is 482913"
  }'

The response confirms the cost and your new balance:

{
  "batch_id": "9d2f7c1e-...",
  "accepted": 1,
  "rejected": [],
  "segments": 1,
  "total_cost": "0.0400",
  "currency": "USD",
  "balance_after": "4.96"
}

The SMS is on its way. Check its status with GET /api/v1/batches/{batch_id}, or watch it arrive on your phone.

Try a dry run first

Add "dry_run": true to the same request and the API prices the batch without sending or billing. Useful while you wire things up.