Skip to main content
This guide walks you through setting up email forwarding in Gmail to automatically send 2FA verification code emails to Kaizen. This enables your automation workflows to receive and process email-based two-factor authentication codes.

​
Overview

Many websites send verification codes via email as part of their two-factor authentication process. By forwarding these emails to Kaizen, your workflows can automatically extract and use these codes during login, eliminating the need for manual intervention.

​
Prerequisites

Before you begin, make sure you have access to the Gmail account that receives the 2FA verification emails you want to forward to Kaizen.

​
Step-by-Step Setup

​
Step 1: Open Gmail Settings

In Gmail, click the gear icon in the top right corner to open Quick settings, then click “See all settings” to access the full settings page.
Gmail Quick settings panel with See all settings button highlighted

​
Step 2: Navigate to Filters and Create a New Filter

In the Settings page, click on the “Filters and Blocked Addresses” tab. Scroll down to the bottom of the page and click “Create a new filter”.
Gmail Settings showing Filters and Blocked Addresses tab with Create a new filter link

​
Step 3: Set Filter Criteria

In the filter creation dialog, enter the email address that sends your 2FA codes in the “From” field. This should be the sender address of the verification emails from the service you want to automate (for example, [email protected]). After entering the sender address, click “Create filter” to proceed to the next step.
Gmail filter criteria dialog with From field and Create filter button

​
Step 4: Enable Email Forwarding

In the filter actions dialog, check the “Forward it to:” checkbox. You will need to add the Kaizen forwarding address if you haven’t already. The forwarding address to use is: [email protected]
Gmail filter actions showing Forward it to checkbox selected
If you haven’t added the forwarding address before, click “Add forwarding address” to add [email protected] as a forwarding destination. Gmail will send a verification email to confirm the forwarding address.

​
Step 5: Create the Filter

After selecting the forwarding option and choosing the Kaizen forwarding address, click “Create filter” to save your filter.
Gmail filter actions dialog with Create filter button

​
Step 6: Contact Kaizen to Verify Setup

After creating the filter, reach out to the Kaizen team to confirm that we have received a verification email from Gmail. This step ensures that the forwarding is properly configured and that Kaizen can receive your 2FA emails.
The forwarding setup is not complete until the Kaizen team confirms receipt of the Gmail verification email. Please contact us to verify your setup before relying on email-based 2FA in your workflows.

​
Using Email 2FA in Your Logins

Once the forwarding is set up and verified, you can configure your logins in Kaizen to use Email as the two-factor authentication method. When your workflow encounters a 2FA challenge, Kaizen will automatically retrieve the verification code from the forwarded email.

​
Troubleshooting

If your 2FA emails are not being forwarded correctly, check the following:
  1. Verify that the filter is active in your Gmail Filters and Blocked Addresses settings
  2. Ensure the “From” address in your filter exactly matches the sender of the 2FA emails
  3. Confirm that [email protected] is listed as a verified forwarding address in Gmail
  4. Contact the Kaizen team if you continue to experience issues

​
Summary

By setting up email forwarding with Gmail filters, you can automate the handling of email-based 2FA codes in your Kaizen workflows. This eliminates manual code entry and enables fully automated authentication flows for services that use email verification.