Table of contents
Connecting Google Workspace
The Google Workspace connection is created the moment an administrator signs up for WorkSights using their Google account. No separate installation is required. The integration begins operating automatically as soon as admin consent is granted.
WorkSights establishes a domain-level connection, which means Workspace activity is processed for all users in that domain who appear in WorkSights.
For the signup steps, see Sign Up with Google Workspace.
Permissions Granted During Admin Consent
When the admin authenticates with Google, WorkSights receives three read-only permission groups:
Import and maintain your user directory: Keeps WorkSights's user list aligned with your Google Workspace domain.
Access calendar metadata: Determines each user's time zone and enriches missing event metadata from audit logs.
Receive audit events for core Workspace services: How WorkSights ingests activity from Calendar, Drive, Meet, Chat, and Login.
Domain Connection Rules
WorkSights allows one connection per Google Workspace domain. Duplicate connections to the same domain are blocked to prevent redundant processing and inconsistent data. Organizations with multiple Workspace domains may add each domain once.
User Import and Identity Matching
After the domain is connected, WorkSights automatically imports all users from your Google directory. New employees are added automatically as they appear in Google Workspace. You can assign WorkSights roles (Admin, Executive, Manager, Member) to control which users participate in dashboards and reporting.
Historical Data Import
WorkSights imports a window of recent activity during the initial connection so new organizations see value from day one.
Initial Import (Default): WorkSights ingests approximately the last 8 days of Workspace activity during the first connection.
Extended Import (Available for expanded plans): Depending on your organization's configuration, WorkSights supports importing up to 120 days of historical Google activity to provide broader context during onboarding and reporting.
Service-Level Controls
After the domain is connected, you can enable or disable specific categories of Google activity inside WorkSights, including Calendar, Drive, Meet, Chat, and Gmail forwarding. These preferences can be applied globally or per user.
Troubleshooting
If the Google Workspace connection is not working as expected:
- Confirm admin consent was granted by a Google Workspace super admin. Partial consent blocks some or all activity.
- Check that the domain appears as connected in Settings under Connected Services.
- If users are missing from WorkSights, verify they exist in the Google Workspace directory and that the domain sync has completed.
- If a specific service such as Drive or Meet is not producing activity, confirm it is enabled in service-level controls.
- For persistent issues, contact support via the in-app chat.