curl --request POST \
  --url https://api.kairosafrika.com/v1/external/sms/bulk \
  --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 '{
    "messages": [
      {
        "to": "233200746417",
        "from": "PHCCU",
        "message": "Dear TETTEH-KORBOE MARIAN (DR), GHS 224.52 Interest on Savings for the 3rd Quarter of 2023\r\nBalance GHS 24471.33.\r\nThank you. PHCCU… Happy Family!",
        "type": "Quick"
      },
      {
        "to": "233559400612",
        "from": "PHCCU",
        "message": "Dear TETTEH-KORBOE MARIAN (DR), GHS 224.52 Interest on Savings for the 3rd Quarter of 2023\r\nBalance GHS 24471.33.\r\nThank you. PHCCU… Happy Family!",
        "type": "Quick"
      }
    ],
    "isGlobal": false
  }'

{
  "statusCode": 201,
  "statusMessage": "Bulk messages successfully sent",
  "transactionId": "e43597d8-2fcb-479f-a4eb-68a3502efa4a",
  "sequenceNo": null,
  "data": {
    "totalBatches": 1,
    "batches": [
      {
        "jobId": "27bf8f64-b804-4d99-b64b-b13efc67d5ed",
        "messages": [
          {
            "to": "233200746417",
            "from": "PHCCU",
            "message": "Dear TETTEH-KORBOE MARIAN (DR), GHS 224.52 Interest on Savings for the 3rd Quarter of 2023\r\nBalance GHS 24471.33.\r\nThank you. PHCCU… Happy Family!",
            "type": "Quick",
            "sequenceNo": "01K6MNZ814E5GDJ5Y95460QY9S",
            "transactionId": "e43597d8-2fcb-479f-a4eb-68a3502efa4a"
          }
        ]
      }
    ],
    "senderAddress": "PHCCU"
  },
  "timestamp": "2025-10-03T09:20:40.575Z"
}

POST

external

sms

bulk

curl --request POST \
  --url https://api.kairosafrika.com/v1/external/sms/bulk \
  --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 '{
    "messages": [
      {
        "to": "233200746417",
        "from": "PHCCU",
        "message": "Dear TETTEH-KORBOE MARIAN (DR), GHS 224.52 Interest on Savings for the 3rd Quarter of 2023\r\nBalance GHS 24471.33.\r\nThank you. PHCCU… Happy Family!",
        "type": "Quick"
      },
      {
        "to": "233559400612",
        "from": "PHCCU",
        "message": "Dear TETTEH-KORBOE MARIAN (DR), GHS 224.52 Interest on Savings for the 3rd Quarter of 2023\r\nBalance GHS 24471.33.\r\nThank you. PHCCU… Happy Family!",
        "type": "Quick"
      }
    ],
    "isGlobal": false
  }'

{
  "statusCode": 201,
  "statusMessage": "Bulk messages successfully sent",
  "transactionId": "e43597d8-2fcb-479f-a4eb-68a3502efa4a",
  "sequenceNo": null,
  "data": {
    "totalBatches": 1,
    "batches": [
      {
        "jobId": "27bf8f64-b804-4d99-b64b-b13efc67d5ed",
        "messages": [
          {
            "to": "233200746417",
            "from": "PHCCU",
            "message": "Dear TETTEH-KORBOE MARIAN (DR), GHS 224.52 Interest on Savings for the 3rd Quarter of 2023\r\nBalance GHS 24471.33.\r\nThank you. PHCCU… Happy Family!",
            "type": "Quick",
            "sequenceNo": "01K6MNZ814E5GDJ5Y95460QY9S",
            "transactionId": "e43597d8-2fcb-479f-a4eb-68a3502efa4a"
          }
        ]
      }
    ],
    "senderAddress": "PHCCU"
  },
  "timestamp": "2025-10-03T09:20:40.575Z"
}

Send Bulk SMS

This endpoint allows you to send SMS messages to multiple recipients in a single request. Endpoint: POST /v1/external/sms/bulk

curl --request POST \
  --url https://api.kairosafrika.com/v1/external/sms/bulk \
  --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 '{
    "messages": [
      {
        "to": "233200746417",
        "from": "PHCCU",
        "message": "Dear TETTEH-KORBOE MARIAN (DR), GHS 224.52 Interest on Savings for the 3rd Quarter of 2023\r\nBalance GHS 24471.33.\r\nThank you. PHCCU… Happy Family!",
        "type": "Quick"
      },
      {
        "to": "233559400612",
        "from": "PHCCU",
        "message": "Dear TETTEH-KORBOE MARIAN (DR), GHS 224.52 Interest on Savings for the 3rd Quarter of 2023\r\nBalance GHS 24471.33.\r\nThank you. PHCCU… Happy Family!",
        "type": "Quick"
      }
    ],
    "isGlobal": false
  }'

Request Body

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

Responses

200 OK: Bulk SMS sent successfully.
400 Bad Request: Invalid request data.
401 Unauthorized: Invalid or missing API key.

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

messages

object[]

required

Array of SMS message objects to send

Minimum array length: 1

Show child attributes

isGlobal

boolean

required

Whether to use global routing

Example:

false

Response

Bulk SMS sent successfully

statusCode

integer

HTTP status code

Example:

201

statusMessage

string

Status message

Example:

"Bulk messages successfully sent"

transactionId

string

Unique transaction identifier

Example:

"e43597d8-2fcb-479f-a4eb-68a3502efa4a"

sequenceNo

string | null

Sequence number

Example:

null

data

object

Show child attributes

timestamp

string<date-time>

ISO 8601 timestamp

Example:

"2025-10-03T09:20:40.575Z"

Getting Started

SMS API

USSD Webhooks

Payment API

Email API

Checkout API

Send Bulk SMS

Send Bulk SMS

Request Body

Responses

Authorizations

Headers

Body

Response

​Send Bulk SMS

​Request Body

​Responses

Authorizations

Headers

Body

Response

Send Bulk SMS

Request Body

Responses