For the complete documentation index, see llms.txt. This page is also available as Markdown.

Wait For Email

Wait until a matching email arrives in a DoesQA inbox.

Wait for email pauses the Test Case until a message arrives in the chosen inbox. Use it after your app sends mail, so later Mail steps read a message that is already there.

Prefer the Test Case inbox with $testEmail when the message belongs to one test. Use the Account inbox with $accountEmail when several tests share one mailbox.

Wait for email Test Step

When to use it

  • Pause until a welcome, reset, or verification email arrives.

  • Filter on Subject or From when the inbox may receive other messages.

  • Raise End Offset when the app is slow to send mail (default is 5 minutes, up to 20).

For a full walkthrough, see Interacting with emails.

Example Flow

Trigger the email, wait for it, open the message, continue from a link, then close the inbox.

Set value, Wait for email, Open email, Touch, and Close inbox

Configure

Basics

Field
What to set

Inbox

Test Case (default) or Account

Type

New (default) waits for a new message. Custom matches a property

Property

When Type is Custom: Subject, From, Reply To, HTML Body, Plain Text Body, or Snippet

Comparison Type

Value

Text and/or Values to match

Advanced

Field
What to set

Start Offset

How far back to look (Test Start by default)

End Offset

How long to keep waiting (5 mins by default, up to 20 mins)

Status on fail

When should screenshots be taken?

Always (default) or On Failures

Value Standardization

Pro tip: Subject and From are the safest filters for everyday Flows. Keep HTML Body and Snippet for cases where the subject alone is not unique.

Tags: mail, wait, email, inbox

Last updated