← Back to docs

Quickstart

Add your domain, send a test email to yourself, then verify to send to anyone

Menu

Send your first email

1. Get an API key

Sign up at dashboard.euromail.dev and create an API key on the API Keys page. Every request sends it as Authorization: Bearer em_live_.... The API also accepts the same key in an X-EuroMail-Api-Key header.

2. Add your sending domain

You can only send from a domain you have added to your account. Add it in the dashboard under Domains, or with the API:

curl -X POST https://api.euromail.dev/v1/domains \
  -H "Authorization: Bearer em_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"domain": "yourdomain.com"}'

The response lists the DNS records to publish. Most go under the em. subdomain (e.g. em.yourdomain.com), which keeps your transactional email reputation separate from your root domain. Until they verify, the domain is in sandbox: you can send from it, but only to your own account email.

3. Send a test email to yourself

While the domain is unverified you can send only to the email address you signed up with, so put that address in to. Pick your language:

cURL

curl -X POST https://api.euromail.dev/v1/emails \
  -H "Authorization: Bearer em_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Hello from EuroMail",
    "html_body": "<h1>It works!</h1><p>Your first email via EuroMail.</p>"
  }'

TypeScript

npm install @euromail/sdk
import { EuroMail } from "@euromail/sdk";

const euromail = new EuroMail({ apiKey: process.env.EUROMAIL_API_KEY! });

const result = await euromail.sendEmail({
  from: "[email protected]",
  to: "[email protected]",
  subject: "Hello from EuroMail",
  html_body: "<h1>It works!</h1>",
});

console.log(result.id, result.status); // uuid, "queued"

Python

pip install euromail
import os
from euromail import EuroMail

client = EuroMail(api_key=os.environ["EUROMAIL_API_KEY"])

response = client.send_email(
    from_address="[email protected]",
    to="[email protected]",
    subject="Hello from EuroMail",
    html_body="<h1>It works!</h1>",
)

print(response.id, response.status)  # uuid, "queued"

Rust

[dependencies]
euromail = "0.7"
tokio = { version = "1", features = ["full"] }
use euromail::{EuroMail, SendEmailParams};

#[tokio::main]
async fn main() -> Result<(), euromail::EuroMailError> {
    let client = EuroMail::from_env(); // reads EUROMAIL_API_KEY, panics if unset

    let response = client
        .send_email(
            &SendEmailParams::new("[email protected]", "[email protected]")
                .subject("Hello from EuroMail")
                .html_body("<h1>It works!</h1>"),
        )
        .await?;

    println!("{} {}", response.id, response.status);
    Ok(())
}

Go

go get github.com/kalle-works/euromail-go
package main

import (
    "context"
    "fmt"
    "os"

    euromail "github.com/kalle-works/euromail-go"
)

func main() {
    client := euromail.NewClient(os.Getenv("EUROMAIL_API_KEY"))

    resp, err := client.SendEmail(context.Background(), euromail.SendEmailParams{
        From:     "[email protected]",
        To:       euromail.ToRecipient("[email protected]"),
        Subject:  euromail.String("Hello from EuroMail"),
        HTMLBody: euromail.String("<h1>It works!</h1>"),
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(resp.ID, resp.Status)
}

4. Check the response

A successful send returns 202 Accepted:

{
  "data": {
    "id": "a1b2c3d4-...",
    "message_id": "<[email protected]>",
    "status": "queued",
    "to": "[email protected]",
    "sandbox": true,
    "scheduled_at": null,
    "created_at": "2026-03-29T10:00:00Z"
  }
}

"sandbox": true means the send went out under sandbox rules: your domain isn't verified yet, so it was accepted only because it goes to your own account address. It is a real email and lands in your inbox. Sending from a domain you haven't added returns 403, and sending to anyone else before verification returns 422 with a message saying which domain to verify.

5. Verify the domain to send to anyone

This step is required before you send to customers. Publish the DKIM, SPF and return-path MX records from step 2 at your DNS provider, then run the check:

curl -X POST https://api.euromail.dev/v1/domains/{domain_id}/verify \
  -H "Authorization: Bearer em_live_your_key_here"

Once DKIM and the return-path both verify, sandbox ends and the same request from step 3 delivers to any recipient. See the Domain Verification guide for step-by-step instructions per DNS provider.

You don't need a card to sign up. If your sending domain was registered less than 30 days ago, though, it needs a no-charge card check before it can send to anyone but you. More on the card check.

If we ask for a card check

Most accounts never see this. We ask for a card check only when an account looks risky: a new account sending to more than 100 people in a day during its first two weeks, a sending domain registered in the last 30 days, or bounces and complaints on recent mail. Sub-accounts count toward their parent account's 100.

When that happens, a send to anyone else returns 403 with the code CARD_VERIFICATION_REQUIRED. The message says which of those we saw and links to the check. Over SMTP the same refusal comes back as 550 5.7.1. We also email you once. Mail to your own address and your verified domains keeps going out.

To clear it, open Billing in the dashboard and click Verify card. Stripe saves the card without charging it, and your bank may ask you to confirm in its app. Paid plans already collect a card at checkout, so they never need this step.

What's next?

API reference

Full interactive API docs at api.euromail.dev/docs.

Send your first email in about 90 seconds

The free tier includes 3,000 emails a month. Email storage and AI processing in Finland, with a DPA on every plan.

Create free account See live delivery data