
Table of contents
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.

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.

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.

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.