Send SMS

Send a single SMS request to one or more recipients.

POST/v1/sms/send

Request Body

Option	Type	Required	Description
`to`	string \| array	yes	Phone number or list of phone numbers. Local Nigerian numbers are normalized to 234 format.
`from`	string	yes	Approved sender ID, 3 to 11 alphanumeric characters.
`message`	string	yes	SMS content.
`channel`	string	no	generic or dnd. Defaults to generic.
`reference`	string	no	Your idempotency or business reference.

{
  "to": "08025671695",
  "from": "NairaSMS",
  "message": "Your order has shipped.",
  "channel": "generic",
  "reference": "order_1001"
}

Sample Response

{
  "message": "SMS request accepted.",
  "campaign": {
    "id": "667000000000000000000001",
    "status": "sent",
    "message_id": "3017600245086449408013699",
    "recipients": 1,
    "amount": 3.2,
    "currency": "NGN",
    "sms_parts": 1
  },
  "requestId": "req-123"
}