Agent Mail Inboxes

View as Markdown

TesterArmy can generate temporary email inboxes for your tests. This is useful for flows that require email verification - sign ups, OTP codes, password resets, invitation links.

Each test run can create a fresh inbox or reuse a static one assigned to the project. The agent reads incoming emails, extracts verification codes or links, and continues the test flow automatically.

How it works

  1. The agent creates an inbox (e.g., test-abc123@inbox.testerarmy.com)
  2. Signs up or triggers an email-based flow using that address
  3. Waits for the email to arrive
  4. Reads the email content, extracts the OTP code or verification link
  5. Continues the test (enters the code, clicks the link)

Static inboxes

You can assign a permanent inbox to your project under Project → Test Accounts. This is useful when you need to re-use the same email across multiple test runs (e.g., testing login for an already-registered account).

You can also view the emails a saved inbox has received: open Project → Test Accounts and click View emails on the inbox. This is handy for checking OTP codes or verification links yourself while debugging a test.