Blacklist

Blacklisted phone numbers are silently skipped when sending messages or campaigns.

Use the blacklist to honour opt-outs and suppression requests. Numbers can be added one at a time or bulk-imported from CSV. A blacklisted number is dropped from every campaign and direct send without raising an error.

List blacklisted numbers

GET/api/v1/blacklist

curl -X GET "https://timisha-solutions-api.salamu.co.ke/api/v1/blacklist" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Add a number

POST/api/v1/blacklist

Parameters

phonereq

string

Phone number in E.164 format

reason

string

Optional reason (audit trail)

curl -X POST "https://timisha-solutions-api.salamu.co.ke/api/v1/blacklist" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "phone": "+254712345678",
  "reason": "STOP request"
}'

Remove a number

DELETE/api/v1/blacklist/{uuid}

curl -X DELETE "https://timisha-solutions-api.salamu.co.ke/api/v1/blacklist/blacklist-uuid" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Bulk import from CSV

POST/api/v1/blacklist/importmultipart/form-data

Upload a CSV with a required phone column. Each row is added to the blacklist for your team.

Form fields

filereq

file

CSV file. Required column: phone. Optional: reason

curl

curl -X POST https://timisha-solutions-api.salamu.co.ke/api/v1/blacklist/import \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@opt_outs.csv"

200: OK

{
  "success": true,
  "data": { "imported": 340, "skipped": 5 }
}

Opt-out keywords

Inbound STOP messages can be wired to add numbers automatically. See Keywords for opt-in and opt-out subscription handling.