Connecting Google Calendar

Overview

Connecting Google to SchoolCal allows SchoolCal to create and manage events on behalf of your school. This setup uses a dedicated Google user, a custom admin role, and a Domain Wide Delegated (DWD) service account so SchoolCal can create and update calendar events securely.

How to Set Up Your Google Environment

Set up your Google environment

1. Create a new Google user to act as the “calendar owner.” Name it something like SchoolCal Admin and use an email such as schoolcal@yourdomain.com.

2. Create a new custom Admin Role in Google Admin Console (for example, Calendar Administrator).

3. Add the required role permissions: Users → Read access and Calendar → All settings. This role should total 9 privileges.

4. Assign your new SchoolCal Admin user to this custom admin role.

5. In Google Admin Console, go to Security → API Controls → Manage Domain Wide Delegation.

6. Click Add New to create a new Domain Wide Delegation entry.

7. Log in to SchoolCal (using the SchoolCal Admin user) at app.schoolcal.com.

8. Click Connections in the left-hand menu.

9. Copy the Client ID shown in SchoolCal.

10. Paste the Client ID into the new entry in Domain Wide Delegation.

11. Enter the required OAuth scopes (verify the current list in Google before continuing):

    • https://www.googleapis.com/auth/calendar.events

    • https://www.googleapis.com/auth/calendar

    • https://www.googleapis.com/auth/admin.directory.user.readonly

    • https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly

Connect Google to SchoolCal

1. In SchoolCal, click Connections in the left-hand menu.

2. Find Google and click Manage Connection.

3. Click Edit.

4. Enter the email address of your SchoolCal Admin Google user.

5. Click Update Connection.

Additional Info

• Avoid changing the SchoolCal Admin user’s password unless necessary, as it may interrupt the integration.

• The SchoolCal Admin user should not be used for any non-SchoolCal activity to maintain clean audit logs.