Send a message

Send a single SMS to one recipient.

Post to the messages endpoint with a sender ID, a recipient phone number, and the text. The message is queued immediately and returns its UUID and status.

POST/api/v1/messages

Parameters

sender_idreq

string

Sender ID UUID or sender name (e.g. MYAPP)

phonereq

string

Recipient E.164 phone (e.g. +254712345678)

messagereq

string

SMS text. Long messages are split automatically.

curl -X POST "https://timisha-solutions-api.salamu.co.ke/api/v1/messages" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "sender_id": "sid-uuid",
  "phone": "+254712345678",
  "message": "Your OTP is 483920. Valid for 10 minutes."
}'

Response

200: OK

{
  "success": true,
  "data": {
    "uuid": "msg-uuid",
    "to": "+254712345678",
    "message": "Your OTP is 483920. Valid for 10 minutes.",
    "sender_id": "MYAPP",
    "status": "queued",
    "parts": 1,
    "created_at": "2026-05-11T09:00:00Z"
  }
}

Track delivery

The initial status is queued. Poll message history or fetch the message by UUID to see it move to sent and delivered.