Test a forgotten-password flow

Test a forgotten-password journey with DoesQA email and the Flow Builder.

A forgotten-password journey is a good early Flow. It covers form fill, email delivery, a reset link, and a new password, all without writing code.

Use the Flow Builder for this walkthrough.

What you need

A website URL you can reach from the internet, with a working forgotten-password page
An account in that application that can receive a reset email
A Value for the new password, such as NEW_PASSWORD

Prefer $testEmail so the reset message lands in this Test Case inbox. See Interacting with emails for inbox choices.

Build the Flow

Open the forgotten-password page

Start with Open. Point it at your forgotten-password URL on the browser you want to use.

Enter the DoesQA address

Add Set value on the email field. Use $testEmail.

That sends the application to the Test Case inbox for this Run.

Request the reset

Add Touch on the submit control that requests the reset email.

Add a short Check text afterward if the page shows confirmation text, so a silent failure is easy to spot.

Wait for the reset email

Add Wait for email from the Mail family.

Set Inbox to Test Case.
Prefer Type Custom with Subject or From wording your application sends.
Raise End Offset in advanced settings when the application usually takes longer than five minutes to send.

Open the email and follow the link

Add Open email with the same Test Case inbox. Choose Latest, or Custom when you need a specific Subject or From.

The message body becomes the active page. Add Touch on the reset link.

When the application opens in a new window or tab, add Switch window from the Runner family so later steps land on the reset form. When you are finished with the message, add Close inbox.

Set the new password

On the reset form, add Set value for the new password and confirmation fields. Use the same Value, such as NEW_PASSWORD, in both places.

Add Touch on the control that saves the password.

Confirm the outcome

Add Checks that match your product:

Confirmation text on the success page with Check text, or
A login with the new password, using Set value and Touch on the sign-in form

If login is shared across Flows, turn that path into a Step Group after this Flow works.

Pro tip: Keep the reset email filter tight with Subject or From. An open inbox that receives other messages is easier to debug when Wait for email matches one clear string.

The finished Flow

Reuse what you built

Piece

Next step

Mail steps

Reuse the same pattern for invite emails. See Interacting with emails and Test registration and email verification.

Save it as a Step Group.

New password

Store it in the Value Store so other Flows can sign in.

PreviousInteracting with emails NextTest registration and email verification

Last updated 5 days ago