Personalized send

Send a different message to each recipient in one request.

Personalized send takes an array of recipients, each with its own phone number and message body. Use it for balances, order updates, or any content unique per person.

POST/api/v1/messages/personalized

Parameters

sender_idreq

string

Sender ID UUID

recipientsreq

array

Array of { phone, message } objects

curl -X POST "https://timisha-solutions-api.salamu.co.ke/api/v1/messages/personalized" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "sender_id": "sid-uuid",
  "recipients": [
    {
      "phone": "+254712345678",
      "message": "Hi Jane, your balance is KES 1,200."
    },
    {
      "phone": "+254723456789",
      "message": "Hi John, your balance is KES 850."
    }
  ]
}'

Response

200: OK

{
  "success": true,
  "data": {
    "queued": 2,
    "parts": 2,
    "created_at": "2026-05-11T09:00:00Z"
  }
}

Each recipient is billed separately

Parts are counted per message, so a longer message for one recipient does not affect the cost of the others.