Documentation

Send email that reaches the inbox

Ránṣẹ́ is a transactional email API for developers. Verify a domain, grab a key, and send over plain HTTPS — deliverability, suppression, templating, and delivery events are handled for you.

The fastest path is three steps: verify a sending domain, create an API key, then call the send endpoint.

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>"
  }'
No SDK required — the API is plain HTTPS + JSON. Every response is wrapped in a { success, data } envelope.

Building blocks

  • Emails — send a message, then track it through queued → sent → delivered. See the quickstart.
  • Domains — verify a domain you own; we configure SPF, DKIM and DMARC. See sending domains.
  • API keys — full, send-only, or domain-scoped keys. See API keys.
  • Webhooks — signed, real-time delivery events. See webhooks.
  • Templates & suppressions — versioned templates with variables, and automatic bounce/complaint suppression.

Base URL

All requests go to https://api.raanse.com over HTTPS. Authenticate with your API key as a bearer token — see the API reference.