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/sdkimport { 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 euromailimport 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-gopackage 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?
- Templates -- Create reusable email templates with MiniJinja syntax
- Webhooks -- Get real-time sent, bounce, and open events
- Email Validation -- Check if an address is valid before sending
- Multiple recipients -- Pass an array to the
tofield:"to": ["[email protected]", "[email protected]"] - Batch sending -- Send up to 500 emails in one request with
POST /v1/emails/batch - Errors & Rate Limits -- Error codes,
429handling and when to retry - GDPR Tooling -- Export and erase user data for compliance
API reference
Full interactive API docs at api.euromail.dev/docs.