Zion English

Connect Google Calendar

Link Google Calendar once so scheduled classes are added automatically to your dedicated Zion English calendar.

# Why connect Google Calendar?

One-time setup that adds scheduled classes to your Google Calendar automatically.

  1. Connect your Google account from My Profile.
  2. The admin tool creates a dedicated Zion English calendar in your Google account on first connect.
  3. When you schedule a class with a start time, a calendar event is created or updated automatically.

# Before you start

You need a Google account you can sign into.

  1. Use the Google account where you want class events to appear.
  2. Sign in with the same email you use for Google Calendar.

# Connect your account

Authorize the admin tool from your profile page.

  1. Open My Profile from the dashboard or navigation.
  2. Scroll to Integrations and click Connect next to Google Calendar.
  3. Sign in to Google if prompted and approve access.
  4. Return to the profile page and confirm the Google Calendar badge shows Connected.
  5. Open Google Calendar and confirm a Zion English calendar was created.

# Schedule a class with Google Calendar

Calendar events appear on class cards after scheduling.

  1. Open Class Schedule and add a class with a start time.
  2. A calendar icon appears on the class card after scheduling when sync succeeds.
  3. Click the calendar icon to open the event in Google Calendar.

# Disconnect or reconnect

Manage your Google Calendar connection from My Profile.

  1. Click Disconnect Google Calendar in Integrations if you need to remove access.
  2. Existing calendar events are not removed automatically when you disconnect.
  3. Reconnect if you switch Google accounts.

# Troubleshooting

Common issues when connecting or scheduling with Google Calendar.

  1. If Connect Google Calendar is missing, ask your administrator to configure Google Calendar for the system.
  2. If connection fails, confirm Google Calendar shows Connected on your profile.
  3. If your Google account is not on the OAuth test user list, ask your administrator to add your email in Google Cloud Console while the app is in Testing mode.
  4. If sync fails for a class, confirm the class has a start time set.

# Administrator: Google Cloud Console setup

Required so teachers on their own Google accounts can connect.

  1. In Google Cloud Console, create a project or select an existing one.
  2. Enable the Google Calendar API under APIs and Services, Library.
  3. Configure the OAuth consent screen: External user type (unless all teachers are in your Google Workspace), app name Zion English Admin, support email, and authorized domains for production.
  4. Add scopes https://www.googleapis.com/auth/calendar and https://www.googleapis.com/auth/userinfo.email.
  5. Set Privacy Policy, Terms, Support URL (/support), and Documentation URL (/docs/connect-google-calendar).
  6. Create an OAuth client ID (Web application). Add authorized JavaScript origins and redirect URIs for local and production, e.g. https://your-domain/zion-english-admin/profile/google-calendar/callback.
  7. Copy Client ID and Client Secret into server GOOGLE_CALENDAR_CLIENT_ID and GOOGLE_CALENDAR_CLIENT_SECRET.
  8. Set GOOGLE_CALENDAR_REDIRECT_URI to the exact production callback URL registered in Google Cloud Console: https scheme, no trailing slash, same host and path the browser uses after Google redirects (check server logs if unsure).
  9. While Testing: add teacher Google emails as test users (up to 100). For production use beyond test users, submit the app for Google verification.
  10. Deploy updated environment variables and restart the server. Verify by connecting from Profile and scheduling a class with a start time.