Quickstart

1. Get an API token

Sign in to your Timisha Solutions dashboard and open Settings → API tokens. Create a token, give it the scopes it needs (for sending, the messages scope), and copy it, it is shown only once.

2. Have a sender ID ready

Every message is sent from an approved sender ID (the name recipients see). Request one under Sender IDs and wait for approval, then use its UUID or name when sending.

3. Send a message

Make a single authenticated request to the messages endpoint:

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."
}'

4. Read the response

A queued message returns its UUID and status. Poll message history or watch delivery status for the final result.

{
  "success": true,
  "data": {
    "uuid": "msg-uuid",
    "to": "+254712345678",
    "sender_id": "MYAPP",
    "status": "queued",
    "parts": 1,
    "created_at": "2026-05-11T09:00:00Z"
  }
}