Getting started

Quickstart

Send your first email in three steps.

1. Create an API key

Sign in to the Relayly dashboard → Developers → API Keys, and create a key with the send scope. Copy it once — it starts with esp_.

2. Install an SDK

pip install relayly        # Python
npm i @relayly/sdk         # Node.js

3. Send an email

from relayly import Client
rl = Client("esp_live_...")
res = rl.transactional.send(
    to="customer@example.com",
    from_email="hello@yourbrand.com",
    subject="Welcome aboard",
    html="<h1>You're in!</h1>")
print(res["message_id"], res["status"])

Or with curl:

curl https://api.relayly.io/api/v1/transactional/send \
  -H "X-API-Key: esp_live_..." -H "Content-Type: application/json" \
  -d '{"to":"customer@example.com","from_email":"hello@yourbrand.com","subject":"Hi","html":"<p>Hello!</p>"}'

That's it. Next: receive delivery events with webhooks →