Skip to main content
POST
/
v1
/
api
/
messages
/
send
Send SMS
curl --request POST \
  --url https://api.gliiv.com/v1/api/messages/send \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "phoneNumbers": [
    "<string>"
  ],
  "message": "<string>",
  "senderId": "<string>"
}
'
{
    "message": "Messages are being sent",
    "status": 200
}

Documentation Index

Fetch the complete documentation index at: https://www.gliiv.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.
{
    "message": "Messages are being sent",
    "status": 200
}