📚 Definition

The "List User Calendars" action retrieves all calendars associated with a specific Google Workspace user. 📆 It provides detailed information about each calendar, such as its ID, description, location, access role, primary status, notifications, default reminders, and more.
This action is especially useful for administrators who need to manage, audit, or automate calendar-related tasks for users across an organization. By connecting via a service account with domain-wide delegation, you can securely access user calendar data without needing their individual consent.

💡 Example Use Cases

Audit User Calendars
🔍 Track and review all calendars associated with a specific user to ensure compliance with organizational policies or identify unauthorized calendars.
Calendar Backup and Documentation
🗂️ Export a user's calendar information for backup or record-keeping purposes before offboarding an employee.
Calendar Access Management
🔒 Review calendar access roles across a user's calendars to identify and adjust permissions, ensuring sensitive events are protected.
Automate Onboarding Processes
🤖 Fetch a new hire's primary calendar and automatically configure default reminders or event templates for streamlined onboarding.
Monitor Calendar Usage
📊 Analyze how many and what types of calendars a user has (e.g., shared, private, public) to better optimize calendar usage across teams.

🛠️ Inputs

🔗 Connection

Description: The Google Workspace Administration connection you must set up to authenticate the action.

Details:
You need to upload a credential JSON file for a service account with Domain-Wide Delegation enabled. 📚 Helpful link: Guide to create a connection

📧 User Email

Description: The primary email address of the user whose calendars you want to retrieve.

Details:
It identifies the user in Google Workspace. Make sure the provided email address is valid and that your service account has the necessary permissions to access the user's calendar information.

📤 Outputs

The List User Calendars action returns a list of calendar items 📋, each containing detailed information about a calendar associated with the user. Here's what each item includes:

🆔 Id

Description: The unique identifier for the calendar.

Purpose: Useful if you want to perform further actions (like updating, sharing, or deleting the calendar).

🔒 Access Role

Description: Shows the level of access the authenticated user (your service account) has on the calendar.

Examples: owner, writer, reader.

📝 Description

Description: A free-text description of the calendar, usually provided by the owner.

Purpose: Helps understand what the calendar is used for (e.g., "Marketing Team Events").

📍 Location

Description: Geographic location associated with the calendar, if provided.

Example: "New York, USA".

🌟 Primary

Description: Indicates whether this calendar is the user's primary calendar (the default personal calendar).

Values: true or false.

👀 Selected

Description: Indicates whether the calendar content is visible in the user's Google Calendar UI.

Values: true or false.

🏷️ Summary

Description: The title or name of the calendar.

Example: "Team Meetings", "Personal Calendar".

🌎 Time Zone

Description: The time zone set for the calendar.

Example: America/Los_Angeles.

🔔 Notifications

Description: Lists any notification settings for the calendar.

Sub-fields:

Method: How the notification is delivered (e.g., email, SMS).
Type: The type of event that triggers a notification (e.g., event creation, event changes).

⏰ Default Reminders

Description: Lists the default reminders configured for this calendar.

Sub-fields:

Method: How the reminder is delivered (e.g., popup, email).
Type: The event or time associated with the reminder (e.g., "10 minutes before event").

🧩 Example

Imagine your HR team needs to manage employees' calendars automatically as part of their onboarding process. When a new employee joins, you want to retrieve a list of all their Google Calendars 📅 to check if a "Work Calendar" already exists.
You set up a flow where the List User Calendars action runs as soon as a new user is added. The flow fetches all calendars for the user's email address and then checks if certain calendars are present — if not, it can trigger another action to create or configure them! 🚀

This automation ensures that every employee has the right calendar setup without needing manual checking or intervention.