Skip to content

Google Calendar Permissions (IT)

CoffeePals can use Google Calendar in two ways, and each needs a different setup in your Google Admin console:

  • Participants pick a time: each person connects their own Google Calendar the first time they book, so CoffeePals needs the right OAuth scopes under App access control.
  • Automated booking: a Google Workspace super admin authorizes CoffeePals once for the whole domain, and CoffeePals books meetings for everyone.

This guide is for Google Workspace administrators. You will need access to the Admin Console to make these changes.

Participants pick a time: allow CoffeePals' OAuth scopes

Before your organization can use CoffeePals with Google Calendar, the app must have access to the correct OAuth scopes. This is managed in the Google Admin Console, under Security → API controls → App access control.

✅ Step 1: Ensure Google Calendar is Enabled

  1. Sign in to Google Admin Console with an administrator account.
  2. Navigate to Apps → Google Workspace → Calendar.
  3. Ensure that Calendar is ON for the Organizational Unit (OU) containing CoffeePals users.

✅ Step 2: Check CoffeePals App Access

  1. In the Admin Console, go to Security → Access and data control → API controls → App access control.
  2. Search for CoffeePals by name or App ID: 970617264601-fqbb0jniro4qmg22fg14a0df0pe86uki.apps.googleusercontent.com.
  3. Select the CoffeePals app.
  4. Under Access to Google data, set CoffeePals to either:
  • Specific Google data — CoffeePals can only request approved scopes (you must ensure Calendar scopes are included).
Google Admin console App access control page for CoffeePals, showing its app ID and the Calendar service with 3 of 3 scopes granted

✅ Step 3: Verify Required Calendar Scopes

CoffeePals needs at least one of the following Calendar scopes:

To confirm:

  1. In the CoffeePals app entry, click Update Google services or scopes.
  2. Ensure that Calendar (3 scopes) is enabled.
  3. Save changes.
CoffeePals in Google Admin's App access control set to Specific Google data, allowing Calendar (3 scopes) and Google sign-in (2 scopes), with the change ready to save

✅ Step 4: Save

  1. Click Save in the Admin Console.

If the calendar dates are not visible in the match card now, message support@coffeepals.com to force a consent refresh.

📌 Summary

  • Calendar service must be enabled.
  • CoffeePals must be Trusted or allowed Calendar scopes.

Once these steps are complete, CoffeePals will be able to schedule meetings in google based on availability.

Automated booking: authorize CoffeePals for your domain

You'll need to be a Google Workspace super admin.

  1. In CoffeePals, go to Settings › Workspace › Calendar and click Connect on Google Workspace.
  2. On I'm the admin, click Open Google Admin console. It opens Google Admin's domain-wide delegation page with the form already filled in.
  3. Check the form and click Authorize. If the form is empty, open Form empty? Copy the client ID and scopes in CoffeePals and paste them in.
  4. Back in CoffeePals, click Verify and check connection.
The Connect Google Workspace dialog: step 1 Authorize CoffeePals in Google Admin with the Open Google Admin console button, and step 2 Verify and check connection

Automated booking asks for these scopes:

  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.freebusy
  • https://www.googleapis.com/auth/calendar.settings.readonly

Google can take up to 24 hours to apply changes, so if the check fails right away, try again later. For the full walkthrough, see How to connect Microsoft 365 or Google Workspace for automated booking.

Updated on: 04/09/2025

Was this helpful?

Still need help?

Chat with our team — we usually reply in a few minutes.

Related articles