Build on Mailfornet

npm install mailfornet

const inbox = await mf.createInbox();
await signUp(inbox.address);
const code = await mf.waitForCode(inbox.address);

No polling loop, no IMAP, and no shared mailbox that two parallel test runs fight over.

Where to go next

What you get

• Wait instead of poll. Pass ?wait= and the request holds open until mail arrives, up to a minute. That's one request, not one a second.
• Filters. Ask for mail from a particular sender or with a subject, so a newsletter arriving first doesn't fail your test.
• Signed webhooks. HMAC-SHA256 over the exact bytes sent, with a timestamp so an old delivery can't be replayed. There's a test-send button.
• Idempotency keys. A retried create returns the first result rather than a second inbox.
• Keys you can restrict. A read-only scope, an expiry date and an IP allowlist, set when you create the key.
• Stable error codes and request ids. Branch on code, never on the message, and quote the request id to support.

The official Node client

The mailfornet package ships TypeScript types, the long-polling helpers and webhook signature verification. You can call the API with plain fetch instead — it's ordinary REST, and the OpenAPI spec will generate a client in most languages.

Ready to start?

Create a developer account, claim the free tier — 100 requests a month, no card — and you can be reading mail from your test suite in a few minutes.