Quickstart
Connect your domain, create an API key and send your first email. The DNS step is the only one that waits on anyone but you.
1. Create an account
Sign up with your work email. You start on the Free plan: 3,000 emails a month, 3 domains and 3 mailboxes. No card needed.
2. Add your domain
In the dashboard, open Domains and add the domain you want to send from, for example acme.dev. If your main domain already receives mail somewhere else (Google Workspace, Microsoft 365), use a subdomain such as mail.acme.dev so nothing changes for your existing mail.
3. Add the DNS records
Zevuki shows eight records. Copy each one into your DNS provider (Cloudflare, Route 53, GoDaddy, Namecheap…), then press Verify. Most providers apply changes within minutes; some take up to an hour. What each record does.
You can send as soon as the sending records (SPF, the three DKIM records and the bounce records) are found. The MX record is needed to receive mail in your mailboxes.
4. Create an API key
Open API keys and create a key with Send only access for your app. Copy it right away: Zevuki only stores a hash, so it can't show the key again. Keep it in an environment variable, never in your code.
5. Send an email
The from address must be on a verified domain in your account.
curl https://mail.zevuki.com/v1/emails \
-H "Authorization: Bearer $ZEVUKI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "Acme <hello@acme.dev>",
"to": "maya@example.com",
"subject": "Welcome to Acme",
"html": "<p>Your workspace is ready.</p>"
}'const res = await fetch("https://mail.zevuki.com/v1/emails", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.ZEVUKI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
from: "Acme <hello@acme.dev>",
to: "maya@example.com",
subject: "Welcome to Acme",
html: "<p>Your workspace is ready.</p>",
}),
})
if (!res.ok) throw new Error((await res.json()).error.message)
const { id } = await res.json()import os, requests
res = requests.post(
"https://mail.zevuki.com/v1/emails",
headers={"Authorization": f"Bearer {os.environ['ZEVUKI_API_KEY']}"},
json={
"from": "Acme <hello@acme.dev>",
"to": "maya@example.com",
"subject": "Welcome to Acme",
"html": "<p>Your workspace is ready.</p>",
},
)
res.raise_for_status()
print(res.json()["id"])A successful request returns 201 Created with the email's ID:
{
"id": "em_5Gk2…"
}Open Emails in the dashboard to follow it from queued to delivered, or ask the API.
Next steps
- Create a mailbox for support@ or yourself, so replies to your emails land somewhere people read.
- Read the full send email reference: CC, BCC, reply-to, plain text and custom headers.
- Handle errors, especially
recipient_suppressedandmonthly_limit_reached.