Validate Email Address

The Validate Email Address action checks an email address before your flow sends anything to it. It performs two checks:

  1. Format validation - confirms the address is syntactically valid. Entries such as invalidemail.com, user@, or @domain.com fail this check.
  2. MX record lookup - queries DNS for the domain's mail exchange (MX) records. A domain with no MX records cannot receive email, so the address is rejected.

How It Works

Place this action before any step that sends an email, so it can confirm the address is valid first. This avoids sending unnecessary emails to addresses that don't exist and protects your sending reputation.

Note

An MX lookup confirms that the domain can receive email. It does not confirm that the specific mailbox exists. An address like neverever@example.com passes as long as example.com has valid MX records.

Adding the Action to Your Flow

  1. Open your flow in the Flow Builder.
  2. Click the + in the top left corner and select Action.
  3. Search for Validate Email and select Validate email address.
  4. Drag the action into your flow and connect it after the screen that collects the user's email.

Searching for the Validate email address action in the Descope flow builder

Error Handling

The action returns a single error, Invalid email address, when the address fails either check. You can set the handling behavior for that error and optionally provide a custom error message, which overrides the default system message.

HandlingBehavior
AutomaticAutomatically return to the previous screen and display the error in its designated message component. This is the default.
MitigateSend the flow to a step you choose and clear the error, treating it as resolved.
ContinueSend the flow to a step you choose and keep the error so it can be displayed there.
IgnoreTreat the step as successful and continue or exit the flow without further error handling.
AbortEnd the flow and send the error to your application instead of showing a screen.

For more detail on each option, see Customizing Flow Errors.

Configuring error handling for the Validate email address action

Testing the Action

Run your flow and submit an address with a domain that has no MX records, such as user@example.invalid. The action fails and, with Automatic handling, returns you to the previous screen with the error message displayed. Submitting a valid address allows the flow to continue to the next step.

Example flow using the Validate email address action

Was this helpful?

On this page