SMS Send

API

Authenticate with the API key from API: Authorization: Bearer ss_.... Numbers in international format: +, country code, number.

Send

curl -X POST https://sms.flo-voice1.com/api/v1/sms \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"to": "+<country code><number>", "text": "Your code is 123456"}'

to is one number or an array of up to 100. Returns 201 with one id per recipient, status queued. Errors carry a code: insufficient_balance, invalid_number, text_too_long, blocked_content, no_line_available (503, retry later), suspended (403).

Status

curl https://sms.flo-voice1.com/api/v1/sms/123 -H "Authorization: Bearer $KEY"
curl "https://sms.flo-voice1.com/api/v1/sms?limit=50" -H "Authorization: Bearer $KEY"

status: queued → sending → sent, or failed (refunded). sent means the mobile network accepted the message.

Webhook

Set a URL on the API page to get sms.sent / sms.failed events, POSTed as JSON with an x-signature: sha256=<hex HMAC of the body with your secret> header.