Quickstart

Create a key and send your first email with evre.

Quickstart

1. Create an API key

Sign in at evre.email, open API keys, and create a key. Copy the secret once — it is not shown again.

Local demo token (mock provider): evre_test_demo

2. Send an email


```bash
curl -X POST https://api.evre.email/emails \
  -H "Authorization: Bearer evre_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: welcome-1" \
  -d '{
    "from": "evre <hi@mail.evre.email>",
    "to": "user@example.com",
    "subject": "Hello from evre",
    "html": "<p>Hi</p>"
  }'

import { Evre } from "@evre/sdk";

const evre = new Evre({
  baseUrl: "https://api.evre.email",
  apiToken: process.env.EVRE_API_TOKEN!,
});

const { id } = await evre.emails.send(
  {
    from: "evre <hi@mail.evre.email>",
    to: "user@example.com",
    subject: "Hello from evre",
    html: "<p>Hi</p>",
  },
  { idempotencyKey: "welcome-1" },
);

console.log(id);


## 3. Verify a domain

Before production sends, add a domain and publish the DNS records evre returns (`POST /domains`, then `POST /domains/{id}/verify`). See [Domains](/domains).

## Next

- [Authentication](/authentication)
- [Attachments & scheduling](/sending/attachments)
- [Full API reference](/api-reference)

On this page

Quickstart 1. Create an API key 2. Send an email