Built for developers.

REST APIs, scoped API keys, a sandbox that behaves like production, signed webhooks and complete message logs.

API reference

A single endpoint accepts every channel. The response returns immediately with a message ID; delivery progress arrives through status polling or webhooks.

POST /v1/messages

{
  "channel": "sms",
  "to": "+974XXXXXXXX",
  "message": "Your order is ready."
}

Response

{
  "id": "msg_01J8...",
  "status": "accepted",
  "channel": "sms",
  "country": "ZM",
  "route": "sandbox",
  "environment": "test"
}

Status model

accepted → queued → processing → sent → delivered, plus read, failed, rejected and undeliverable.

Sandbox

Test without live telecom credentials. The sandbox adapter simulates outcomes, applies a configurable delay and can call your webhook endpoint. Nothing is sent to a real recipient.

…01

Delivered

…02

Failed

…03

Timeout

…04

Rejected

Webhooks

message.acceptedmessage.sentmessage.deliveredmessage.readmessage.failedmessage.rejected

Every delivery is signed with your endpoint's signing secret and logged with the HTTP status and attempt count so you can replay failures.

Platform status

Live component health is published inside the console and the admin portal. Only sandbox adapters are configured until market providers are contracted.

Get API Key