Disposable Email#

Create and read temporary Mail.tm inboxes for testing email flows.

Use bundled scripts#

• Create inbox + token:
  • python3 scripts/create_inbox.py
  • Returns JSON with address, password, token, accountId, domain.
• List messages:
  • python3 scripts/read_inbox.py --token <TOKEN> --list
• Read latest message:
  • python3 scripts/read_inbox.py --token <TOKEN> --latest
• Wait for OTP from incoming mail:
  • python3 scripts/read_inbox.py --token <TOKEN> --wait-otp --timeout 120 --interval 3
  • Default OTP regex: \\b(\\d{4,8})\\b
  • Override regex with --otp-regex.
• End-to-end (create inbox + wait for first message/OTP):
  • python3 scripts/e2e_otp.py --timeout 120 --interval 3
  • First line emits inbox_created JSON (address/password/token).
  • Then emits one of: otp_found, message_received_no_otp, or timeout.
  • Add --save ./otp-result.json to persist the latest emitted result to disk.

Workflow#

1. Run create_inbox.py and share the generated email address.
2. Trigger email delivery to that address.
3. Poll with read_inbox.py ( --latest or --wait-otp).
4. Return sender, subject, createdAt, and message text/OTP.

Notes#

• Free temp domains can be blocked by some production services.
• Keep token private; treat it like mailbox access credentials.
• Prefer stable paid inbox providers for CI if reliability is critical.