Quickstart

1. 1

   Verify a sending domain. You can only send from a domain you own and have verified. Add a domain →

2. 2

   Create an API key. It's shown once — store it as a secret. Create a key →

3. 3

   Call the send endpoint with your key:

curl -X POST https://api.raanse.com/v1/messages \
  -H "Authorization: Bearer rk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
        "from": "Acme <noreply@acme.co>",
        "to": "customer@example.com",
        "subject": "Welcome to Acme",
        "html": "<h1>Hello 👋</h1><p>Thanks for signing up.</p>"
      }'

Authenticate

Pass your API key as a bearer token on every request (or use the X-Api-Key header):

Authorization: Bearer rk_your_api_key

Safe retries

Send an Idempotency-Key header on retryable requests. A retry with the same key returns the original message instead of sending twice — useful for OTPs and receipts.