🧾 Definition

The "List Verification Codes" action allows administrators to retrieve the current set of valid backup verification codes for a specific user within a Google Workspace domain. These codes are used as part of the user's 2-Step Verification (2SV) process to gain access when other authentication methods (like a mobile prompt) are unavailable. With this action, admins can securely view which backup codes are active for a user, making it useful for support, security audits, and recovery procedures. It returns key details including the user’s email, un

💡 Example Use Cases:

🔐 Account Recovery Assistance

Help a user regain access to their account by retrieving their current backup verification codes when they’ve lost access to their usual 2SV method.

✅ 2-Step Verification Audit

Periodically check whether users have valid backup codes configured to ensure compliance with internal security policies.

👥 User Onboarding Validation

Verify that newly onboarded users have been issued backup codes as part of their 2SV setup during the onboarding process.

🛠️ Automated IT Support Flows

Integrate into an IT support workflow to automatically retrieve and present verification codes upon approved admin request, streamlining user support.

📋 Security Reporting

Generate reports showing which users have backup verification codes available, helping to identify accounts lacking secondary authentication options.

Inputs :

Connection

This input is required to authorize Zenphi to interact with your Google Workspace environment. You must set up a Google Workspace Administration connection, which allows Zenphi to act on behalf of your organization.To create this connection, you’ll need to upload a JSON credential file generated from a Google service account that has domain-wide delegation enabled. This ensures Zenphi can securely access user account settings, such as retrieving verification codes. 👉 Follow this guide to set it up:Creating a Google Workspace Administration Connection

User Primary Email

The primary email address of the user whose verification codes you want to retrieve.This field tells Zenphi exactly which user's account to query. The email address should be the current primary email of the user within your Google Workspace domain (e.g., [email protected]). Providing this ensures that the verification codes are fetched for the correct user.

Outputs :

User Primary Email

This is the primary email address of the user for whom the verification codes were retrieved. It helps confirm that the output data corresponds to the correct user account.Useful for logging, auditing, or when working with multiple user records in an automated flow.

User ID

The unique identifier assigned to the user by Google Workspace. Unlike email addresses, which can change, this ID remains consistent and is ideal for internal referencing or linking user records across systems.Helps when you need a reliable, system-level reference to the user.

Verification Codes

A list of the user’s current backup verification codes. These codes serve as an alternative method for 2-step verification if the user can’t access their primary authentication device.This data is essential for support or recovery scenarios where users are locked out of their accounts, and it enables admins to retrieve the current codes for reference or distribution through secure channels.

📘 Example Scenario: Retrieve Backup Codes for Locked-Out User

An IT administrator receives a request from an employee who has lost access to their phone and cannot complete 2-Step Verification to log in. To quickly assist, the admin uses the "List Verification Codes" action within a Zenphi flow.

They configure the action by selecting their Google Workspace Admin connection and entering the employee's primary email address. Once the flow runs, it returns the employee’s active backup verification codes. The admin securely shares one of the codes with the user, allowing them to regain access to their account without disabling 2-Step Verification entirely.