Developer documentation

Textblaster SMS API

Use https://www.textblaster.co.uk/api or the branded API domain shown in your dashboard. Create a key with the permissions your application needs.

Send a transactional SMS

curl https://www.textblaster.co.uk/api/v1/messages \
  -H "Authorization: Bearer $TEXTBLASTER_KEY" \
  -H "Idempotency-Key: order-8841-shipped" \
  -H "Content-Type: application/json" \
  -d '{"to":"+447700900142","from":"Juniper","body":"Your order has shipped."}'

The API queues the message and returns 202, a message ID and the number of segments reserved. Use an approved sender for live traffic. Sandbox sends return sandbox: true and never contact a carrier.

Retry with the same idempotency key and the same payload. Reusing a key with changed data returns 409. Delivery states include queued, submitting, accepted, delivered, undelivered, failed and unknown. An unknown delivery is held for review.

Endpoints and scopes

GET /api/v1/balancecredits:read
POST /api/v1/messagesmessages:send
GET /api/v1/messages/{id}messages:read
GET /api/v1/clientsclients:read
POST /api/v1/clientsclients:write
POST /api/v1/clients/{id}/creditscredits:allocate

Client creation accepts name. Credit allocations accept credits, an external payment reference and an Idempotency-Key header. Only master reseller accounts can use these endpoints.