Skip to Content
DocumentationIntegrationGoogle CalendarWho Am I

Who Am I

Retrieves the current authenticated user’s basic information from Google. This action provides the user’s unique identifier and email address.

Overview

  • Purpose: Get basic information about the currently authenticated Google user.
  • Use Cases: User identification, email verification, account validation, displaying current user info in UI, linking Google accounts to internal user records.
  • API Method: GET /whoami
  • Google API: Uses Google’s OAuth2 /oauth2/v1/userinfo endpoint.

Input Fields

No Input Required: This action does not require any input parameters. It automatically retrieves information for the currently authenticated user based on the OAuth token.

Output

  • User ID: Unique Google identifier for the user. This is a numeric string that uniquely identifies the user across Google services.
  • Email: The user’s primary email address associated with their Google account.

Authentication

  • OAuth Token: Uses the OAuth access token from the current session to identify the user.
  • Automatic: No additional authentication steps required - uses existing connection.
  • Scope: Works with standard Google OAuth scopes, no special calendar scopes needed.

Use Cases

  • User Verification: Confirm which Google account is currently connected.
  • Account Linking: Link Google user ID to your internal user database.
  • Email Display: Show the connected email address in your application UI.
  • Multi-Account Support: Identify which account is active when users have multiple Google accounts.
  • Audit Logging: Record which Google user performed actions in your system.

Tips

[!TIP] Use the user ID as a stable identifier - it won’t change even if the user changes their email

[!TIP] Store the user ID to link Google accounts with your internal user records

[!TIP] Call this action after OAuth connection to verify the connected account

[!TIP] The email returned is the primary email - users may have multiple emails

[!TIP] Use this for displaying ‘Connected as: user@example.com’ in your UI

[!TIP] No special scopes required - works with basic OAuth authentication

Need help? Have feedback?
OverviewGet Calendar Settings