Overview

Isolated inboxes for E2E tests. Keep the production sender; change only the recipient.

Mailwurf is a public mailbox for automated tests. The app under test keeps Resend, SES, or any other real sender. Tests create a temporary inbox, fill that address into the app, and wait for the message over HTTP.

Mail arrives on public MX. Tests read it over HTTP. Do not point the application's SMTP host at Mailwurf.

Flow

Create one temporary inbox per test.
Use the returned address as the recipient in the app.
Wait until the mail is there. The server waits; the client does not poll.
Read links and otp from the message.

Parallel tests must not share an inbox.

Start here

TypeScript client

@mailwurf/e2e, the fetch wrapper tests actually call.

HTTP API

Plain HTTP under /api/v1, with /v1 as an alias.

API Reference

OpenAPI pages with request and response schemas.

Playwright

Copy-paste spec: signup, wait, follow the confirm link.