Developers

Email aliases built for developers

Create and manage aliases with a REST API. React to incoming email with signed webhooks. Build email workflows without the complexity.

API-first alias management

Create an alias

curl -X POST https://mailservr.app/api/addresses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "notifications", "domainId": "DOMAIN_ID"}'

List inbox threads

curl https://mailservr.app/api/emails \
  -H "Authorization: Bearer YOUR_API_KEY"

Webhook payload (email.received)

{
  "event": "email.received",
  "data": {
    "threadId": "thr_abc123",
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Deployment successful",
    "receivedAt": "2026-02-13T10:30:00Z"
  }
}

Full API reference Webhook documentation Password manager setup

Common developer workflows

CI/CD notification routing

Create one alias per repository or pipeline. Route GitHub, Vercel, and AWS alerts to categorized addresses. Triage by alias in the inbox instead of writing complex filter rules.

SaaS trial isolation

Spin up a temporary alias for each free trial. Use the API to create the alias, sign up, and delete the alias after the trial ends. No more trial spam in your real inbox.

Customer support routing

Give each client or ticket system a unique alias. All communication is organized by address. When the engagement ends, deactivate the alias.

Internal tool integration

Use webhooks to push incoming email events to Slack, Discord, or your own monitoring stack. React to email.received events in real time without polling.

Password manager alias generation

Connect Bitwarden or 1Password to mailservr's SimpleLogin/Addy.io-compatible API. Aliases are auto-generated when creating new logins without leaving your password manager.

Developer plan comparison

Capability	Pro ($20)	Enterprise ($60)
API keys	1	10
Webhook endpoints	Not included	Up to 5
Active aliases	50	200
Daily send limit	20	100
Monthly send limit	500	2,000
Attachment storage	1 GB	10 GB
Password manager integration	Yes	Yes

Developer FAQ

What authentication does the API use?

The API uses Bearer token authentication. Generate API keys from your dashboard settings. Pro plans include 1 API key, Enterprise plans include up to 10.

Are webhook payloads signed?

Yes. Every webhook payload is signed with HMAC-SHA256. Your endpoint can verify the signature to ensure payloads are authentic and untampered.

What events do webhooks support?

Webhooks fire on email.received, email.sent, and thread.created events. Enterprise plans support up to 5 webhook endpoints with delivery logs and retry logic.

Does mailservr work with Bitwarden and 1Password?

Yes. mailservr implements the SimpleLogin and Addy.io alias generation protocols. Configure your password manager to use mailservr as the alias provider and aliases are generated automatically when creating new logins.

Start building with mailservr

API access included in every plan. One-time payment, no rate-limit surprises.

Get Started View pricing