Last updated
November 12th, 2026

Connecting Google Workspace

A Google Workspace admin connects the whole domain once. Only Owners, Executives and Admins can connect services, and the Google account you sign in with must be a Workspace admin.

For the WorkSights signup steps, see Sign Up with Google Workspace.

Connecting Google Workspace

Step 1: Start the Connection

Go to Services in the top navigation, find Google Workspace, and click Connect.

Google Workspace card on the WorkSights Connected Services page

Step 2: Authorize as a Workspace Admin

Sign in as a Google Workspace admin and grant the requested read-only permissions. The directory and audit scopes only work for admin accounts, so a non-admin authorization fails.

WorkSights requests three read-only permission groups:

  • Directory access, to keep the WorkSights user list aligned with your domain
  • Calendar metadata access, to read event details, times, and attendees
  • Audit event access, to receive activity from Calendar, Drive, Meet, Chat, and Login

Step 3: Complete the Provisioning Wizard

After authorizing, you land in the provisioning wizard. Choose which features to enable (Calendar, Drive, Chat, Meet, Email), map the imported directory users, assign roles, and assign managers. Only mapped users with an active feature subscription generate activity.

User Provisioning review screen in WorkSights showing each imported identity and its state

What Happens Next

On connect, WorkSights starts receiving activity and imports the last 30 days for the provisioned users, so timelines are populated from day one. Ongoing activity appears within about 10 minutes.

Overview tab of the Google Workspace service in WorkSights

The user directory stays current through directory-change updates and a daily sync. You can review and update feature settings and user mappings at any time from the integration page.

For a longer history, we can run a manual import going back up to about 126 days, the limit of Google's audit retention. Contact us at [email protected] for more information.

Related Guides

Google Workspace Overview

Google Calendar

Google Drive

Google Meet

Google Chat

Google Logins

Gmail Activity

Gmail Forwarding