API reference

Send SMS programmatically with the smskick REST API. Create an API key from Settings → API keys in your dashboard, then authenticate with a bearer token. Sends debit your credit balance and respect the same rate limits and opt-out rules as the dashboard.

Authentication

Pass your API key as a bearer token. Keys are shown once at creation - store them securely.

Authorization: Bearer sk_live_your_key_here

POST /api/v1/messages

Send a single SMS. Returns the created message with its id and status.

curl -X POST https://smskick.com/api/v1/messages \
  -H "Authorization: Bearer $SMSKICK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+19805550100", "body": "Hello from smskick!"}'

{
  "id": 1234,
  "to": "+19805550100",
  "status": "queued",
  "segments": 1,
  "cost_credits": 1
}

GET /api/v1/messages/:id

Fetch the current status of a message you sent.

curl https://smskick.com/api/v1/messages/1234 \
  -H "Authorization: Bearer $SMSKICK_API_KEY"

{ "id": 1234, "to": "+19805550100", "status": "sent", "segments": 1 }

Errors

401 - missing, invalid, or revoked API key
422 - invalid phone number, recipient opted out, or insufficient credits