|docs
Start Trial

Incident Management

Google Calendar Extension

The Google Calendar extension syncs calendar events with PagerDuty. The extension integrates with Shift Agent to detect scheduling conflicts before they impact coverage, and it operates independently to support standalone scheduling needs. This integration reduces manual availability updates and maintains operational continuity while respecting scheduled commitments.

Availability

The Google Calendar extension is available on all pricing plans.

Permission Scope Details

  • The Google Calendar integration connects at an account level. PagerDuty reads Out of Office events only for Google Calendar accounts with a corresponding PagerDuty user. PagerDuty identifies users by matching email addresses.
  • The scope https://www.googleapis.com/auth/calendar.events.freebusy does not enable PagerDuty to view all calendar events or user data.
  • PagerDuty does not store data unrelated to Out of Office events. PagerDuty stores and displays Out of Office dates and times for specific users on the PagerDuty schedule page to determine conflicts.
  • PagerDuty cannot read event titles, view users on events, or write to calendars.

Set Up the Google Calendar Extension

  1. In Google Workspace, follow the instructions to Create a service account to share credentials with PagerDuty. In Advanced settings, configure the following fields:

    FieldValue
    Domain-wide DelegationEnable
    Google Workspace Marketplace OAuth ClientEnable

  2. Navigate to Main Menu APIs & Services OAuth consent screen.

  3. Select Data Access and click Click or remove scopes.

  4. Click the Filter search field and select Scope.

  5. Search for and select https://www.googleapis.com/auth/calendar.events.freebusy.

  6. Select the Google Calendar API checkbox and click Update.

A screenshot of the Google Workspace cloud admin console showing how to enable the scope https://www.googleapis.com/auth/calendar.events.freebusy web app Enable Google Calendar API Scope

  1. In the PagerDuty web app, navigate to Integrations Extensions.
  2. Click New Extension and select Google Calendar.
  3. On the Google Calendar extension page, upload your Google Workspace token file. View Google's Creating a service account documentation for more information about your Google Workspace access token.
  4. Navigate to the Google Workspace Admin Console and add a new client with an ID matching the service account client ID.
    • Note: You can add only one file for each Google Workspace.

Upload Google Workspace access token Upload Google Workspace Access Token

Calendar Event Limit

A limit of 1,000 total future calendar events exists per calendar.

Google Calendar Update Schedule

Shift Agent ingests Google Calendar data once per hour and does not immediately detect recent conflicts. Manually share out-of-office information with Shift Agent (for example, I am going to be on vacation June 13) to immediately include recent availability updates.

Use Focus Time to Block Meetings

The Focus Time event type blocks your calendar for lunch or other times to prevent meetings. This event type auto-declines events without triggering PagerDuty conflict detection.

Configure Account-Level Notification Settings

Navigate to Integrations Extensions Google Calendar to adjust notification settings.

When enabled, you can suppress Slack conflict alerts that occur during your Google Calendar Out of Office (OOO) event. Alerts outside the OOO window deliver normally. This configuration reduces noise from last‑minute OOO blocks added to schedules.

Google Calendar Notification Settings Google Calendar Notification Settings