Sendblue Docs

Install

mkdir -p ~/.local/bin
curl -fsSL https://sendblue.abstract.inc/cli/sendblue -o ~/.local/bin/sendblue
chmod +x ~/.local/bin/sendblue
sendblue auth sb_live_your_key
sendblue doctor

CLI commands

sendblue send --to +14155550123 --text \"Hello\"
sendblue usage
sendblue doctor

Phone numbers must use E.164 format. The CLI reads the key from SENDBLUE_API_KEY first, then ~/.config/sendblue/key.

REST API

POST /api/v1/messages

curl https://sendblue.abstract.inc/api/v1/messages \\
  -H \"Authorization: Bearer $SENDBLUE_API_KEY\" \\
  -H \"Content-Type: application/json\" \\
  -d '{\"to\":\"+14155550123\",\"text\":\"Hello\"}'

GET /api/v1/usage returns the plan, count, limit, remaining messages, and reset date.

Errors

  • 401 — invalid or revoked key
  • 400 — invalid phone number or body
  • 429 — monthly limit reached
  • 502/503 — messaging provider unavailable

Security

Keys are shown once and stored only as SHA-256 hashes. Never commit a key, put it in browser code, or include it in logs. Revoke and replace a key from the dashboard if it may have been exposed.