Home Admin & Settings Google Workspace Integration

Google Workspace Integration

Last updated on Apr 17, 2026

Google Workspace Integration

Connect KyberGate to your school's Google Workspace to automatically sync students, teachers, and organizational units. This integration eliminates manual user management and keeps your KyberGate roster in sync with your directory.

Before You Begin

  • You need Google Workspace Super Admin access
  • You need Admin role or higher in KyberGate
  • Your school must have Google Workspace for Education

Setting Up the Integration

  1. In your KyberGate dashboard, navigate to Settings → Integrations
  2. Click Connect Google Workspace
  3. Click Authorize — you'll be redirected to Google's OAuth consent screen
  4. Sign in with your Google Workspace Super Admin account
  5. Review the requested permissions and click Allow:
    • Read user directory (names, emails, OUs)
    • Read classroom rosters (for KyberClassroom groups)
    • Read user profile information
  6. Once authorized, you'll be redirected back to KyberGate

Configuring Sync Settings

After connecting, configure what gets synced:

  1. Select Organizational Units (OUs): Choose which OUs to import (e.g., /Students, /Students/Grade 5)
  2. User Type Mapping: Map Google Workspace user types to KyberGate roles (students, teachers, staff)
  3. Sync Frequency: Choose automatic sync interval (every 1, 6, 12, or 24 hours)
  4. Google Classroom Integration: Optionally sync Google Classroom rosters to auto-create KyberClassroom groups
  5. Click Save & Sync Now to run the initial import

What Gets Synced

  • User accounts: Name, email, OU, status (active/suspended)
  • Organizational units: Full OU hierarchy for grouping
  • Classroom rosters: Teacher-to-student assignments (optional)
  • New users: Automatically added when created in Google Workspace
  • Removed users: Flagged as inactive (not automatically deleted)

Tips

  • Start by syncing a single OU to verify everything works before importing your entire directory
  • Google Classroom sync is especially useful for KyberClassroom — teachers automatically see their class rosters
  • The initial sync may take a few minutes for large directories (1,000+ users)
  • Changes in Google Workspace typically reflect in KyberGate within one sync cycle

Troubleshooting

  • Authorization fails: Ensure you're signing in with a Super Admin account, not a regular teacher or student account
  • Missing users after sync: Check that the correct OUs are selected in sync settings. Suspended Google accounts are imported but marked inactive
  • Classroom rosters not appearing: Verify Google Classroom sync is enabled and that teachers have active Google Classrooms with enrolled students
  • Sync errors: Check Settings → Integrations → Sync Log for detailed error messages

Related Articles