Prerequisites
In Zoho Directory:
- Organization Owner or Admin in Zoho Directory
In Google Workspace:
- User address should be updated in the below given format to ensure successful user import
<Street>,<City>,<State>-<Postal/Zip Code>,<Country>
You can now proceed to configure Google Workspace directory store for Zoho Directory.
Add Store
- Sign in to Zoho Directory, then click Admin Panel in the left menu.
- Click Directory Stores and click Add under Google Workspace.

- In the next page, click Authorize. A new tab opens requesting you to authenticate using your Google account.
- Enter the credentials of your Google Workspace admin account and login, then click Continue.
- Select the list of permissions to provide for Zoho Directory, then click Allow. Upon successful authnetication, you can proceed t field mapping.
Under FIELD MAPPING, map the fields in Zoho Directory with the corresponding fields in Google Workspace. During user import, user data from Google Workspace will be updated in Zoho Directory fields based on the configuration in this section.
You can choose to map fields from Google Workspace with a hard-coded value in Zoho Directory. For example, you can configure the work location for all users synced from Google Workspace to be 'India' in Zoho Directory. To do this:
- Hover over the field you wish to configure a hard-coded value and click Edit.
- Select Hardcoded value and enter the value to update.
- Click OK.

In a similar way, you can choose to map fields from Google Workspace to contain a custom Google Workspace attribute. To do this:
- Hover over the field you wish to configure with a custom Google Workspace attribute and click Edit.
- Select Custom Google Workspace Attribute and enter the value to update.
- Click OK.
Click Save and Next once you have configured field mapping.
In this section, you can configure user settings, such as password notification.
- Under Password Notification, choose how new users can access their accounts.
- You can choose to send an OTP via email to the user or the admin, which can be used to access the account and reset the password.
You can choose not to notify anyone and send the user invitation manually.
Password Notification can be configured only for users whose email address has a verified domain name.
- Click Save and Next.
- Under Status Sync, choose how the change in user status in Google Workspace should be reflected in Zoho Directory.
- Click Save and Next.
- Under Criteria, choose how you want to sync users from Google Workspace. You can either sync all the users or few users based on criteria in Zoho Directory.
- To set criteria, select a criteria from the options, choose a relationship, and enter the criteria's value as needed.
- You can also set multiple criteria. To add more than one criteria, click beside the criterion 1, enter your condition (whether OR or AND), and define the next criteria.

- Once done, click Save and Close.
Import Users
This section lets you configure the user import process from Google Workspace to Zoho Directory. Users in Google Workspace who meet the chosen criteria will be listed as follows:
- New Users - Google Workspace users who do not have an account in Zoho Directory will be listed here. During user import, users you select here will be added to Zoho Directory.
- Update Users - Google Workspace users who are already added to Zoho Directory will be listed here. During user import, the details of the users you select here will be updated in Zoho Directory.
- Users to Activate - This section lists Google Workspace users who are part of Zoho Directory but are inactive. During user import, users you select here will be activated in Zoho Directory.
- Users to Deactivate - This section lists users who are deactivated in Google Workspace but are active in Zoho Directory. During user import, the users you select here will be deactivated in Zoho Directory.
To configure user import,
- Select the required users and click Next.
- Click Import Users.
If the user count is more than 200, the import will happen as a staged process and might take time.
User information in Google Workspace and Zoho Directory will be synced once the user import is complete.