Definition

The "List Forwarding Addresses" action retrieves all forwarding email addresses associated with a specified Gmail account. It allows administrators and users to view which external addresses emails can be forwarded to, along with their verification status.
This action is especially useful for managing email flows, auditing security settings, and ensuring compliance with organizational policies in Google Workspace environments.

Key capabilities include:

• Quickly listing all forwarding addresses for a Gmail account.
• Verifying which addresses are approved and ready for use.
• Supporting automated audits and email system maintenance.

Example Use Cases

1. Security Audits
Quickly retrieve all forwarding addresses to ensure no unauthorized or suspicious external accounts are set up for email forwarding.

2. Compliance Monitoring
Regularly list forwarding addresses to verify compliance with internal policies or regulatory requirements, such as GDPR or HIPAA.

3. Employee Offboarding
During employee exit procedures, check and review forwarding addresses to prevent accidental or unauthorized data leakage.

4. Email Workflow Management
Assist IT teams in managing and optimizing email forwarding setups for shared mailboxes or department accounts.

5. Troubleshooting Email Delivery
Identify and validate forwarding addresses when investigating email routing issues or complaints about missing emails.

Inputs

1. Connection

A Google Workspace Administration connection.

• Explanation: This connection uses a service account with domain-wide delegation to access Gmail settings.
• Important Note: You must upload a credential JSON file for the service account.
• Guide: Follow this guide to create the required connection.
• Best Practice: Ensure the service account has the correct scopes and admin permissions before using.

2. User Email

The email address of the Gmail user whose forwarding addresses you want to list.

• Explanation: Enter the complete and valid email address (e.g., [email protected]).

Outputs

The List Forwarding Addresses action returns a list of items, where each item contains the following fields:

1. Forwarding Email

The email address to which messages can be forwarded.

• Explanation: This is the actual forwarding destination address set up in the user's Gmail account.
• Example: If a user has set up forwarding to [email protected], it will appear here.
• Note: Multiple forwarding addresses may be listed if the user has configured more than one.

2. Verification Status

Indicates whether the forwarding email address has been verified.

• Explanation: Only verified addresses are actively usable for forwarding emails.
• Example Values:
  • Verified: Ready and active for forwarding.
  • Pending: Awaiting confirmation from the forwarding address.

Example

Scenario:
An IT administrator wants to audit all forwarding addresses set up by employees to ensure no sensitive company emails are being automatically forwarded to external accounts.

How to Set It Up:

• Add the List Forwarding Addresses action to the flow.
• Select the Connection (Google Workspace Administration connection with the proper service account credentials).
• Enter the User Email of the account you want to check.
• Run the flow to retrieve a list of all forwarding addresses and their verification status.

Outcome:
The administrator receives a detailed list showing all active forwarding addresses for the specified Gmail account, helping ensure company data is secure.