Quickstart

Esemes Gateway sends SMS from your own Android phone and SIM through a simple REST API. Messages can only go to Mauritian mobile numbers (+230 5xxx xxxx). Access is by invitation.

1. Pair a phone

In the console open Phones → Add device. Install the Esemes Gateway app on an Android phone, tap Scan QR code, then Start gateway and pick a SIM.

2. Create a project and a key

Projects → New project, then New key. Pick Test while you build: nothing is sent and every result is simulated (see Test mode). Switch to a Live key when you are ready. Keys are shown once.

Keep the key on your server. Never put it in browser or mobile-app code: anyone could read it and send SMS from your SIM.

3. Send a message

curl https://sms.bizmakers.app/v1/messages \
  -H "Authorization: Bearer $ESEMES_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "5123 4567", "body": "Your ticket T-1042 is ready: https://example.com/t/1042"}'

The answer is 202 Accepted with the message (id, state: "queued"). The phone sends it within seconds.

4. Follow it

GET https://sms.bizmakers.app/v1/messages/{id} shows its state and history: queued → dispatched → sent → delivered (or failed, expired, canceled). Better: add a webhook and be told.

Next