--- title: "Google User Repository Integration" slug: "google-user-repository-integration" tags: ["SysAid Classic", "SysAid Spaces"] updated: 2026-03-11T14:00:28Z published: 2026-03-11T14:00:28Z --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.sysaid.com/llms.txt > Use this file to discover all available pages before exploring further. # Google User Repository Integration Sync your Google Workspace Users and Groups into SysAid and map their user information fields to corresponding SysAid fields. > [!NOTE] > **Requirements:** > > - Google > - Google Workspace Administrator > - SysAid > - SysAid 24.2.20 and above > - SysAdmin permission > - Google User Repository Integration installed and activated in SysAid SysAid SysAdmins and Admins with Google Workspace accounts use the Google User Repository Integration to import and sync their organization’s Users and Groups from Google Workspace – thereby having all the information you need to best deliver support via SysAid Service Desk. This document provides the steps needed for SysAdmins to activate and configure the Google User Repository Integration, so that their organization can begin using it in SysAid, including how to: 1. [Get Google User Repository Integration](/classic/docs/google-user-repository-integration#get-google-user-repository-integration) 2. [Activate Integration](/classic/docs/google-user-repository-integration#activate-integration) 3. [Add Google Repository](/classic/docs/google-user-repository-integration#add-google-user-repository) 4. [Test Integration Connection](/classic/docs/google-user-repository-integration#test-integration-connection) 5. [Import Users & Groups](/classic/docs/google-user-repository-integration#import-user-fields) 6. [Confirmation of Import](/classic/docs/google-user-repository-integration#confirmation-of-import) > [!NOTE] > Google Workspace API: > > To learn the steps required to enable the API in Google Workspace, [read this guide](https://documentation.sysaid.com/docs/set-up-google-user-repository-integration) ### How synchronization works The Google User Repository Integration syncs every 24 hours. This sync involves the following: - Importing all Users from Google User Repository to SysAid - Importing all Groups from Google User Repository to SysAid - Mapping Users with Groups - Disabling deleted Google users ## Step 1: Get Google User Repository Integration 1. In SysAid, go to **Connect**and click **Explore** in the Marketplace banner. 2. Search for **Google Apps User Repository**and click on the card. 3. Click **Setup and manage**. You will be redirected to the **My add-ons** page, where you’ll see **Google Apps User Repository**. 4. Click the **gear icon**. ## Step 2: Activate Integration ![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1717677066610.png) Turn on the **Activate integration** toggle. This will enable the syncing process between your Google User Repository and SysAid. ## Step 3: Add Google User Repository ![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1717677182349.png) Configuring (and activating) your Google Repository will allow you to sync your Users and Groups information between Google and SysAid. Adding your Google Repository requires uploading your Google Repository credentials .JSON file. To do this, enter: | Name | Criteria | Required? | Example | | --- | --- | --- | --- | | Repository Name | None (name created by Admin) | Yes | Sysaid | | Domain Name | Domain corresponding to the Google domain that the user repository belongs to | Yes | sysaid.com | Once you’ve added Repository Name and Domain Name, click Add to choose select your Google Credentials .JSON file. #### Upload Google credentials .JSON file ![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1717677339564.png) This pop-up form will appear after clicking **Add**. Upload the JSON file from your File Manager. > [!NOTE] > Please note: > > The confirmation message will appear in a new tab. I**f you’re using an ad-blocker**, you might not see the confirmation message. Make sure to turn off the ad-blocker or use a different browser for this action. If the file (and credentials) are valid, it will appear in the Repository list, as shown below: ![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1717677430122.png) ## Step 4: Test Integration Connection ![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1717677979599.png) After successfully adding the repository, you can test the connection between the Google User Repository and SysAid by clicking Test Connection (shown above). Once the connection is successful, you should see the following success message: ![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/image-1717678014886.png) ## Step 5: Import User Fields #### Map User Fields ![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/modify field map.jpg) The Google User Repository import process provides the option to adjust which SysAid Fields correspond to the fields used in your Google Workspace account. To choose or change which SysAid Field a Google field is mapped with, select the field you want to change from the relevant row. > [!NOTE] > Example: > > To map the field value of the **Department** field you’re importing from Google Workspace into your **Floor** field in SysAid, you can choose this in the corresponding dropdown field #### Add Filters (optional) ![](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/add filters to google import cropped.jpg) You can modify which data is imported from your Google User Repository, using the following filters: | Filter | Filter Method | Impact | | --- | --- | --- | | Import Groups | Single select checkbox | Integration will include Groups | | Filter Group Import | Admin creates Advanced Filter (SysAid functionality) | Advanced Filters (with option for multiple AND/OR statements) determine which Fields to import from Groups | | Filter User Import | Admin creates Advanced Filter (SysAid functionality) | Advanced Filters (with option for multiple AND/OR statements) determine which Fields to import from Users | | Import Active Users only | Single select checkbox | Integration will include **only** Active Users | | Filter out users without First Name and Last Name | Single select checkbox | User records without **First Name** and **Last Name** Fields won’t be included in the import. | Once you’ve added any desired filters, click **Save Changes**. You can then click **Import now**. ## Import confirmation After reloading the page, the import is considered complete once the **Import** button is active and the **Last run** field displays the time of the last run. #### Where to see imported users After finishing the import, imported Users and Groups can be found in **Settings > User Management > End Users/Groups**.