Skip to main content

Google Calendar

Allow Suger to access and manage your Google Calendar events, enabling automated scheduling and calendar management workflows.

Overview​

Google Calendar is a time management and scheduling service developed by Google. It allows users to create, edit, and manage events and calendars, with support for reminders, guest invites, and integration with other Google Workspace services.

By integrating Suger with Google Calendar, users can automate workflow tasks such as creating calendar events, managing schedules, sending invites, and synchronizing calendar data across systems for efficient appointment and meeting management.

Org-Level vs User-Level​

When to use Org-Level: Use org-level integration when you want all users in your organization to have access to Google Calendar data through a shared service account. Best for company-wide calendar access and scheduling automation.

When to use User-Level: Use user-level integration when each user needs to connect their personal Google Calendar account. Each user authenticates with their own credentials to access their private calendar events and schedules.

Create Integration (Org-Level)​

Prerequisites​

  • A GCP project with the Calendar API enabled
  • A service account with appropriate IAM permissions

Authenticate by Service Account​

  1. Create a service account in your target GCP project for Google Calendar integration.

    info
    • Grant the service account with the IAM role Service Account Token Creator under the GCP project.

  2. Enable the Google Calendar API in the same Google project.

  3. Create the service account key, and download the associated JSON file. It is required for the following integration.

  4. Enable G-Suite Domain-wide Delegation for the service account.

    info
    • In the "OAuth Scopes" field, select the appropriate scopes for Google Calendar access.

  5. Specify the impersonated email address, select the appropriate scopes configured in the previous step, and store the JSON key file contents within the Suger console integration page.

    info
    • Enter the Impersonation Email (a user email from your company) that Suger will impersonate to access calendar on behalf of the user. It MUST be a user email, instead of a group email, since group emails cannot be impersonated.
    • Select the appropriate OAuth scopes for calendar access.

Create User Integration​

  1. Click Connect Now button in the User Integrations section

  2. Select OAuth2.0 as the authentication method and click Create

  3. You will be redirected to Google to authorize

  4. Click Allow to grant Suger permission to access your Google Calendar

  5. Return to Suger to confirm connection

  6. Verify the integration by clicking the Verify button. If the integration is successful, you will see the Verified status.

Edit Integration​

Editing is not supported for security reasons. To change configuration, delete the integration and create a new one.

Delete Integration​

The Google Calendar integration can be deleted like all other integrations. Once the deletion is triggered, all integration info including the service account with the key will be deleted immediately & permanently from Suger. No time window or methods to recover.

warning
  • To completely delete the integration, please delete the service account and the key as well.
  • If you are using user-level integration, the OAuth consent will remain active until revoked manually in your Google account settings.