Guides

E2E Flows

Use captured email to complete real signup, invitation, password reset, and OTP flows in browser tests.

Password reset flow

Trigger the reset in Playwright or another browser runner, poll the account INBOX over the API, extract the reset link from text or HTML, and continue the test through the actual route your users receive.

curl -H "X-API-KEY: $SMTPDEV_API_KEY" \
  "https://stmp.ink/api/accounts/1/mailboxes/1/messages?q=password%20reset"

Real-time events

Subscribe to /api/events with an API key to receive message.received payloads. For smoke tests, add ?once=1 so the stream returns the latest message event and exits.

curl -N -H "X-API-KEY: $SMTPDEV_API_KEY" \
  "https://stmp.ink/api/events?once=1"