Spin up a disposable email address that actually receives mail, then poll it from your test suite or your own script. Built for verification-email testing, signup-flow QA, and anywhere you'd otherwise burn a real inbox.
Free — no API key required to create a mailbox# create a mailbox (default: expires in 15 min)
curl -X POST https://receivemail.dev/mailboxes
# => {"address":"a1b2c3d4e5f6@receivemail.dev","expiresAt":"...","secret":"..."}
# now trigger your app's verification email to that address, then poll:
curl https://receivemail.dev/mailboxes/a1b2c3d4e5f6@receivemail.dev/messages \
-H "Authorization: Bearer <secret from above>"
# => {"address":"...","messages":[{"from_address":"...","subject":"...","body_text":"..."}]}
| Endpoint | Description |
|---|---|
POST /mailboxes | Create a new address. Optional {"ttlMinutes": 1-60} body, default 15. Returns the address and a per-mailbox secret — save it, it's the only way to read this mailbox later. |
GET /mailboxes/:address | Mailbox metadata (created/expiry). Needs the mailbox's own secret as a Bearer token. |
GET /mailboxes/:address/messages | Last 50 messages received, newest first. Same secret. |
@receivemail.dev accepts mail, even ones never explicitly reserved — but only a reserved address gives you a secret to read it back