# Hep.gg SMS API

Send outbound SMS via the SMS worker. Authentication is a per-account bearer
token created on the dashboard (/dashboard/sms/api-keys).

Worker base URL: https://sms.hep.gg
Auth: Authorization header set to the raw token (no "Bearer " prefix).

## Endpoints

### POST /api/messages
Send a single SMS.

Form-urlencoded body:
  recipient   string   E.164 phone number (e.g. +14155551212).
  content     string   Up to 799 chars; multi-SMS supported by chunking client-side.

Response: 200 with provider metadata on success, 400/401/403/500 on error.

### GET /api/messages
List sent + received SMS rows for the bearer's account.

## Pricing
  - 1 credit per SMS sent (regardless of length up to 799 chars).
  - Top up via the dashboard. Free 1000-credit grant on application approval.

## Hep.gg-side dashboard endpoints (cookie auth)
Listed for completeness; programmatic callers use the worker directly above.
  GET   /api/v1/sms/account
  PATCH /api/v1/sms/account
  POST  /api/v1/sms/auth/rotate
  GET   /api/v1/sms/messages
  GET   /api/v1/sms/credits
  GET   /api/v1/sms/credits/bundles
  GET   /api/v1/sms/credits/history
  POST  /api/v1/sms/credits/checkout
  POST  /api/v1/sms/credits/checkout/paypal