Skip to main content
POST
Send SMS
The /send endpoint allows you to programmatically dispatch messages to your recipients. All requests are processed through our high-speed gateway to ensure rapid delivery.
Requirement: Before using this endpoint, you must have at least one Sender identity assigned to your account.

Headers

X-API-Key
string
required
Your secret API key used to authenticate the request.

Body Parameters

phoneNumbers
string[]
required
An array of recipient phone numbers.
  • Supported Formats: +250..., 250..., 07..., or 7...
  • Limit: Maximum of 20 numbers per individual API request.
message
string
required
The text content of your SMS.
  • Billing: Charged in 160-character segments.
  • Maximum: 800 characters total.
senderId
string
required
The unique ID of your authorized Sender. Retrieve this from the List All Senders endpoint.

Response Body

message
string
A descriptive message detailing the outcome of the request.
status
number
The HTTP status code associated with the response.
validationErrors
object
Optional. Returned only on a 400 Bad Request. Contains field-specific error messages.