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
- Sign in to Google Admin Console with an administrator account.
- Navigate to Apps → Google Workspace → Calendar.
- Ensure that Calendar is ON for the Organizational Unit (OU) containing CoffeePals users.
✅ Step 2: Check CoffeePals App Access
- In the Admin Console, go to Security → Access and data control → API controls → App access control.
- Search for CoffeePals by name or App ID: 970617264601-fqbb0jniro4qmg22fg14a0df0pe86uki.apps.googleusercontent.com.
- Select the CoffeePals app.
- 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).

✅ Step 3: Verify Required Calendar Scopes
CoffeePals needs at least one of the following Calendar scopes:
- Minimum required:
- openid
- https://www.googleapis.com/auth/calendar.events.owned
- https://www.googleapis.com/auth/calendar.settings.readonly
- https://www.googleapis.com/auth/calendar.events.freebusy
To confirm:
- In the CoffeePals app entry, click Update Google services or scopes.
- Ensure that Calendar (3 scopes) is enabled.
- Save changes.

✅ Step 4: Save
- 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.
- In CoffeePals, go to Settings › Workspace › Calendar and click Connect on Google Workspace.
- 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.
- 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.
- Back in CoffeePals, click 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.