Authentication

SuperSend TX authenticates API requests with Bearer API keys that start with stx_.

Obtain a key

  1. Open the dashboard.
  2. Go to API Keys → Create.
  3. Copy the secret — it is shown once.
export SUPERSENDTX_API_KEY=stx_your_key_here

Keep keys server-side only. Never ship them in browser bundles or public repos.

Request header

Send the key on every management and send request:

curl https://api.supersendtx.com/emails \
  -H "Authorization: Bearer $SUPERSENDTX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "you@yourdomain.com",
    "to": "user@example.com",
    "subject": "Hello",
    "html": "<p>It works.</p>"
  }'

Node SDK

import { SuperSendTX } from 'supersendtx'

const client = new SuperSendTX(process.env.SUPERSENDTX_API_KEY)

CLI

export SUPERSENDTX_API_KEY=stx_your_key_here
npx -y --package=supersendtx-cli -- supersendtx emails send \
  --from you@yourdomain.com \
  --to user@example.com \
  --subject "Hello" \
  --html "<p>It works.</p>"

Base URLs

Surface URL
API https://api.supersendtx.com
Dashboard https://app.supersendtx.com

Unauthorized responses

Missing or invalid keys return 401 with:

{
  "error": {
    "message": "Unauthorized"
  }
}

See Errors for the full error shape.