Quickstart
Get MepMail running and send your first email in a few minutes.
MepMail runs the same whether we host it for you or you run it yourself — same dashboard, same API, same SDKs. Pick your deployment below; the tabs remember your choice across the docs.
1. Get MepMail
Create your account at mepmail.dev/signup, then
sign in at mepmail.dev. The Send Free plan needs no card
and sends up to 100 emails per UTC day. Paid Send plans and the Mail trial
have their own payment terms; see current plans.
The API is at api.mepmail.dev.
Try a dashboard email before DNS
In the dashboard's onboarding, use Send test to my inbox to send to your own account address. You do not need to add a domain or create an API key for this first test. This sends a real test message to you; it does not validate your application's API integration. For SDK or REST sends, continue with domain verification below.
2. Verify a sending domain
MepMail only sends from domains you have verified.
- In the dashboard, go to Domains and add a domain you control
(e.g.
acme.dev). - Add the DNS records it shows you — a DKIM TXT record plus MAIL FROM records — at your DNS provider.
- Click Verify DNS records. MepMail also resolves the records live, so you can see immediately which ones are still missing.
Validation is asynchronous on the DNS provider's side: DKIM usually resolves in minutes, MAIL FROM can take longer. MepMail re-checks on its own every 15 minutes, so you never have to click twice.
3. Create an API key
Go to API keys and create one. The ms_ token is shown once — copy it
now. Keys can be scoped to full access or sending-only, and optionally pinned
to a single domain.
4. Send an email
Your API base URL:
https://api.mepmail.dev
With curl:
curl -X POST https://api.mepmail.dev/emails \
-H "Authorization: Bearer ms_..." \
-H "Content-Type: application/json" \
-d '{
"from": "Acme <onboarding@acme.dev>",
"to": ["delivered@example.com"],
"subject": "Hello from MepMail",
"html": "<strong>It works!</strong>"
}'Or with the official Resend SDK for Node 20+ (npm install resend), pointed at your
base URL:
import { Resend } from "resend";
const resend = new Resend("ms_...", {
baseUrl: "https://api.mepmail.dev",
});
const { data, error } = await resend.emails.send({
from: "Acme <onboarding@acme.dev>",
to: "delivered@example.com",
subject: "Hello from MepMail",
html: "<strong>It works!</strong>",
});
if (error) console.error(error.name, error.message);
else console.log("accepted", data.id);Both return { "id": "..." } when accepted into the queue. Acceptance is not
delivery: persist the ID and follow the email on Emails or through
webhooks until a delivery or failure event arrives.
On a self-hosted instance, delivery events (delivered, bounced, complained) require the SES event pipeline configured in Self-hosting → SES events. On the managed service they flow automatically.
Already on Resend? Keep the SDK you have and point it here: set the base URL to
your MepMail origin and use your ms_ key. The wire format is identical, and
SDKs has the exact option for each language — including the ones that
only read it from an environment variable.
Next steps
- Concepts for contacts, segments, topics, and broadcasts.
- SDKs for how to point each official Resend SDK at your instance.
- API reference for every endpoint.
- Self-hosting for production deployment, the environment reference, and the SMTP relay.