POST/v1/messaging/sms

SMS & WhatsApp Messaging

Deliver transactional OTPs, identity verification alerts, and customer notifications via high-deliverability SMS or WhatsApp gateways.

COST PER SMS5 NGX (₦5.00)

DELIVERY CHANNELSSMS, WhatsApp, Voice

Request Parameters

Field	Type	Required	Description
destination	string	Required	Recipient mobile number (e.g. 2348012345678).
message	string	Required	Text content of the notification message.
channel	string	Optional	Delivery channel: `sms` (default), `whatsapp`, or `voice`.
senderId	string	Optional	Approved alphanumeric Sender ID tag.
priority	boolean	Optional	Deliver via high-priority priority gateway (default: false).

Example Request & Response

cURL Request

curl -X POST https://api.verixaid.com/v1/messaging/sms \
  -H "Authorization: Bearer vrx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "2348012345678",
    "message": "Your Verixa verification code is 849201. Do not share this code.",
    "channel": "sms",
    "senderId": "Verixa"
  }'

Response (200 OK)

{
  "status": "success",
  "data": {
    "status": "Sent",
    "mobile": "2348012345678",
    "message_id": "vx_c8095767-c69f-4bd7-aa52-7cb469effb51",
    "reference_id": "cc7f9a23-959a-4708-ac6e-5cffec7682ba"
  },
  "billed_amount": 5,
  "meta": {
    "provider": "verixa",
    "latency_ms": 112
  }
}