
Table of contents
Sign Up with Google Workspace
WorkSights connects to your organization's Google Workspace through OAuth 2.0. Setup takes around five minutes and requires a Google Workspace admin account.
New or Existing Account?
If your organization already has a Business account, you can join only if you are an active member with WorkSights sign-in access enabled. Using the same email domain is not enough. Being a Google Workspace administrator does not bypass these requirements.
If access is unavailable, the access page shows whom to contact. Ask the account Owner to review your membership and sign-in access. Signing up again does not make you the Owner of an existing account. An eligible provider administrator receives Admin access when joining it.
If there is no Business account for your domain, a provider administrator can create one and becomes its Owner. A non-admin can follow the Personal account flow instead. The steps below cover connecting your organization and setting up a new Business account.
Before You Begin
To connect your organization's directory and activity sources, sign in as a Google Workspace administrator. WorkSights uses admin-level OAuth to import your team and begin capturing activity signals across connected services. A non-admin user cannot complete the connection.
Make sure pop-ups are enabled in your browser. Google's OAuth consent screen opens in a new window.
Setup Steps
Step 1: Create Your Account
Go to worksights.ai and click Get Started. On the sign-up page, enter your work email, name, company name, and company size, then click Continue.

Step 2: Sign In with Google
WorkSights redirects you to Google to authenticate. Select your Google Workspace admin account and click Continue.
Step 3: Grant Permissions
Google displays the permissions WorkSights is requesting. These are read-only scopes covering:
- Audit reports for your Google Workspace domain
- User directory information
- Google Calendar data
Select all permissions and click Continue. WorkSights cannot capture activity signals without these scopes.

Step 4: Set Up Your Account
Once Google authentication is complete, WorkSights takes you to the account setup screen. Enter your account name and confirm your location and timezone. Optionally, add a short description of your organization. This helps WorkSights provide more relevant findings.
Under Activity Sources, Gmail, Google Calendar, Google Drive, Google Meet, and Google Chat are selected by default. Deselect any services you do not want WorkSights to capture activity from. You can change this later from Settings.
Accept the Terms and Conditions and click Continue to User Selection.
Step 5: Select Your Team
WorkSights imports the users found in your Google Workspace. Review the list and confirm who should have access to WorkSights. Click Continue.
Step 6: Assign Roles
Assign elevated permissions to specific team members:
- Executives - full visibility across the organization
- Admins - can manage connections and account settings; this role alone does not grant visibility into everyone's activity or activity estimates
- Managers - can view activity for direct and indirect reports throughout their reporting hierarchy, and edit only direct reports
Everyone not assigned a role is a Member by default and can see their own activity only. You can update roles at any time from Settings. Click Continue, or Skip to return to this later.
Step 7: Set Up Org Structure
Drag and drop team members to build your reporting hierarchy. Once all users are assigned, click Finish.
WorkSights opens on your Home Screen. Your workspace is active, and activity data begins appearing as signals are captured from your Connected Services.
Step 8: Account Setup in Progress
After you click Finish, WorkSights sets up your account in three stages:
- Setup - your account configuration is saved
- Importing - activity data is imported from each connected service for each team member
- Processing - activity estimates are computed across your team
This usually takes a few minutes. WorkSights emails you when it is done. You do not need to stay on this page.

Once all three stages complete, click See the Activity Dashboard to open your workspace.

Security and Privacy
WorkSights connects to Google Workspace using OAuth 2.0, the same authentication framework Google uses for its own applications.
- Permissions are strictly read-only
- WorkSights never stores or manages your Google password
- WorkSights never edits, moves, or deletes content in your Google Workspace
- WorkSights processes activity metadata only. It does not read the content of emails, documents, or messages
You can revoke access at any time in Google Admin Console → Security → API Controls → App Access Control.
Troubleshooting
OAuth error after granting permissions
If you see an error after completing the Google consent screen, your OAuth session may have expired. Close the browser tab, return to app.worksights.ai/start, and begin the sign-up flow again.
Non-admin account
If you are not a Google Workspace administrator, you cannot complete the connection step. The admin who completes setup should start the sign-up from the beginning. Starting the flow as a non-admin and switching accounts mid-setup is not supported.
Permission not granted
If you deselected one or more permissions on the Google consent screen and the connection fails, return to Settings and reconnect Google Workspace, granting all required scopes.
What Happens Next
Once your account is ready, open the Activity Dashboard to see your team's activity signals and start exploring your workspace.