Follow these steps to connect your Google Workspace account and begin syncing users and groups into Substly.
Prerequisites
Before you begin, make sure:
You have administrator access to your Google Workspace domain.
You know which users or groups you'd like to sync to Substly.
How to install the integration
Log in to Substly as an admin.
Go to Integrations & Imports > Google Workspace.
Click Activate and sign in with your Google Workspace admin account.
Grant the required permissions (see Permissions article).
Choose which users and/or groups to sync.
Confirm and start the sync process.
Choosing which groups and users to sync
Once you've granted access and reached the sync setup screen, you'll see two tabs: Groups and Users.
Groups tab
The search bar is pre-filled with the word
employee, which filters and shows groups containing "employee" or "employees".If no groups appear, try clearing the filter or entering another search term.
⚠️ If your organization has a large number of groups, clearing the search filter may take some time to load all available options.
✅ Pro tip: When you sync a group, any users added to that group later in Google Workspace will automatically be added to Substly—no manual updates required.
Users tab
If your organization doesn’t actively work with groups in Google Workspace, go to the Users tab.
From there, you can select individual users to sync directly, without relying on group structures.
You can also filter the view by Organizational Units, Status, or Groups to simplify bulk adding.
Syncing individually or in bulk
Use the checkboxes on the left to select individual users or groups.
To select everything shown on the page, click the checkbox at the top of the list.
As you make selections, the sync status will update from Not synced to To be synced.
Once your selections are complete, click Next to continue the setup process.
You can update or remove synced users/groups at any time from the integration settings.
What happens after installation?
Substly will immediately begin syncing your selected users and groups, along with all the services used by the chosen users.
The first time you set up the sync, it may take up to 24 hours for all data to be displayed in Substly.
Substly will automatically keep your selected users and groups in sync (new data is synced daily).
You will be able to see if synced users have authenticated with a connected service using Google SSO, based on token status.
You can return to this screen at any time to add/remove users or groups, or disconnect the integration.
To further enhance your monitoring capabilities and gain usage insights, we recommend you install the Substly Extension.
Related Articles