REST + SDKs · self-host friendly

Temporary email, programmatic

Create inboxes, read messages and pull OTPs over a simple REST API — or the typed SDKs on top of it. Point it at your own deployment with one config flag.

Get an API key Built for tests

Clean REST API

Create, list, read and delete inboxes with a single X-API-Key header.

Typed SDKs

Python and JS/TS clients wrap the API with retries and OTP polling built in.

Bring your own domain

Use a verified domain of your own, or point the SDK base URL at a self-hosted instance.

curl -X POST https://mailflat.net/api/v1/inboxes \
  -H "X-API-Key: mf_live_..." \
  -d '{"label":"signup"}'
# → { "address": "signup-…@….mailflat.net" }

Frequently asked questions

Is there a REST API or just SDKs?

Both. The SDKs are thin wrappers over a public REST API (/api/v1) you can call directly.

Can I use my own domain?

Yes — verify a domain and create inboxes on it, or self-host and set the SDK base URL.

How is it authenticated?

A single account API key sent as the X-API-Key header.

Related

email testing api email for ai agents mcp email tool

Ready to try it?

MailFlat — instant email inboxes for testing, automation & AI agents.