Skip to main content

How to connect Google Calendar with Sally AI

Once your Google Calendar is connected, Sally can read your meetings (with the right permissions) and join them without a separate invitation. All your scheduled events then show up right in Sally.

Quick navigation

  1. How to connect Google Calendar
  2. Required OAuth scopes

1. How to connect Google Calendar

  1. Open Settings at the bottom of the left sidebar.
Sally sidebar with the Settings entry highlighted at the bottom left
Figure 1: Open Settings
  1. Under Configuration, select Integrations and click Discover integrations.
Sally integrations page with no connected integration and the Discover integrations button
Figure 2: Discover integrations
  1. Pick Google Calendar from the Calendar section of the list. You can also find an integration directly through the search field at the top.
List of all available integrations in Sally with the Google Calendar entry highlighted
Figure 3: Select Google Calendar from the list
  1. The panel describes the integration and notes that every member connects their own account. Click Connect in the bottom right corner.
Detail view of the Google Calendar integration with the Connect button highlighted in the bottom right
Figure 4: Start the connection
  1. Sign in with your Google account and you are connected.

  2. (Optional) Open the Calendars tab of the connected integration. Under Sync settings you get two toggles:

    • Sync private appointments: enable it if you want Sally to sync your private appointments as well.
    • Only sync online meetings: enable it if you only want to sync appointments that carry an online meeting link, for example Microsoft Teams, Google Meet, or Zoom.

Below that, Synced calendars shows which calendars Sally includes. Your main calendar is marked as Primary calendar, and you can add further calendars such as public holidays one by one. Use Disconnect in the top right corner to remove the integration again.

Calendars tab of the integration with the sync settings and the synced calendars
Figure 5: Set up the synchronization
  1. Once connected, you will see all your appointments in Sally.
Sally appointment view with the appointments synced from Google Calendar
Figure 6: Your appointments appear in Sally
Info

Synchronization may take a few moments. Restart Sally if necessary.

Once the connection is in place, you can set whether and when Sally should automatically join your meetings.

Whether a calendar may be connected at all is up to owners and admins, see managing calendars for your users.


2. Required OAuth scopes

For the integration with Google Calendar, Sally uses OAuth 2.0 for authorization. The following scopes define which areas Sally can access on behalf of the authenticated user.

Disclaimer
  1. Sally accesses this information solely to technically establish and maintain the connection to the user account.

  2. Sally does not make any autonomous changes. Actions are performed exclusively upon the explicit initiative of the user.

  3. API endpoints are only called within the scope of an active action initiated by the user within the platform.

Technical overview of required scopes

ScopeWhat Google technically allows with this scopeHow Sally uses this scope
openidOpenID Connect identity verificationSally reads the unique user ID to properly authenticate the connected Google account.
https://www.googleapis.com/auth/userinfo.emailAccess to the user's email addressSally reads the email address to uniquely identify the connected account.
https://www.googleapis.com/auth/userinfo.profileAccess to basic profile informationSally reads basic profile data (e.g., display name) for authentication and account identification. No profile data is modified.
https://www.googleapis.com/auth/calendar.readonlyRead access to calendar dataSally reads relevant calendar information to correctly recognize meetings within the integration context. No events are modified.
https://www.googleapis.com/auth/calendar.eventsAPI permission for calendar eventsPart of Google's calendar integration permission model. Sally does not create, edit, or delete calendar events within the Google account.