Skip to main content
POST
/
v1
/
external
/
sms
/
quick
curl --request POST \
  --url https://api.kairosafrika.com/v1/external/sms/quick \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-api-secret: YOUR_API_SECRET' \
  --header 'x-api-version: 2025-08-01' \
  --header 'Content-Type: application/json' \
  --data '{
    "to": "233559406612",
    "from": "Kairos",
    "type": "Quick",
    "message": "Hello from Kairos Afrika!",
    "isGlobal": false
  }'

{
  "statusCode": 201,
  "statusMessage": "Sms successfully sent.",
  "transactionId": "b0cdebad-e925-4437-b852-5aab112781f0",
  "sequenceNo": "01K6MN2T13XNK40X17F5FH45DV",
  "data": {
    "totalBatches": 1,
    "batches": [
      {
        "jobId": "b7d80ca9-4839-407c-b696-74c4ab2c570e",
        "messages": [
          {
            "to": "233559400612",
            "from": "BLUEFS",
            "message": "This is a testing message from the production server apis",
            "type": "Quick",
            "sequenceNo": "01K6MN2T13XNK40X17F5FH45DV",
            "transactionId": "b0cdebad-e925-4437-b852-5aab112781f0"
          }
        ]
      }
    ],
    "senderAddress": "BLUEFS"
  },
  "timestamp": "2025-10-03T09:05:08.745Z"
}

​
Send Quick SMS

This endpoint allows you to send a quick SMS message to a single recipient. Endpoint: POST /v1/external/sms/quick 
curl --request POST \
  --url https://api.kairosafrika.com/v1/external/sms/quick \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-api-secret: YOUR_API_SECRET' \
  --header 'x-api-version: 2025-08-01' \
  --header 'Content-Type: application/json' \
  --data '{
    "to": "233559406612",
    "from": "Kairos",
    "type": "Quick",
    "message": "Hello from Kairos Afrika!",
    "isGlobal": false
  }'

​
Request Body

  • to (string, required): Recipient phone number (without + prefix).
  • from (string, required): Sender ID or name.
  • type (string, required): SMS type (use “Quick” for quick SMS).
  • message (string, required): The SMS message content.
  • isGlobal (boolean, required): Whether to use global routing (true/false).

​
Responses

  • 200 OK: SMS sent successfully.
  • 400 Bad Request: Invalid request data.

Authorizations

​
x-api-key
string
header
required

API Key for authentication

​
x-api-secret
string
header
required

API Secret for authentication

Headers

​
x-api-version
enum<string>
required

API version header (required for full JSON response)

Available options:
2025-08-01

Body

application/json
​
to
string
required

Recipient phone number (without + prefix)

Example:

"233559406612"

​
from
string
required

Sender ID or name

Example:

"Kairos"

​
type
string
required

SMS type (use 'Quick' for quick SMS)

Example:

"Quick"

​
message
string
required

The SMS message content

Maximum string length: 1600
Example:

"Hello from Kairos Afrika!"

​
isGlobal
boolean
required

Whether to use global routing

Example:

false

Response

SMS sent successfully

​
statusCode
integer

HTTP status code

Example:

201

​
statusMessage
string

Status message

Example:

"Sms successfully sent."

​
transactionId
string

Unique transaction identifier

Example:

"b0cdebad-e925-4437-b852-5aab112781f0"

​
sequenceNo
string

Sequence number

Example:

"01K6MN2T13XNK40X17F5FH45DV"

​
data
object
​
timestamp
string<date-time>

ISO 8601 timestamp

Example:

"2025-10-03T09:05:08.745Z"