POST/v1/messages

Send a message

Send a single SMS (WhatsApp/Voice channels reserved). Priced from the rate card, wallet debited, routed to the SMSC. Pass an optional Idempotency-Key header to make retries safe.

Auth: Bearer token in the Authorization header.

Parameters

to	string	Destination in E.164, e.g. +2348034104102
channel	string	sms \| whatsapp \| voice
from	string	Sender ID (optional)
body	string	Message content (GSM-7 / UCS-2 auto-detected)

Status codes

201Accepted — message queued/sent

402insufficient_funds

403recipient_opted_out

422Validation error

502dispatch_failed (carrier rejected — refunded)