Google Directory Sync

Keep your Visitly employee directory automatically up to date using your Google Workspace account.

How it works

Visitly connects to your Google Workspace account using the Google Directory API. Once connected, any changes you make in Google Workspace; new hires, updated profiles, or removed employees, will automatically reflect in Visitly within 24 hours. No manual updates needed on the Visitly side.

You can also trigger a manual sync anytime you need changes to show up immediately.

Before you begin

You'll need Google Workspace Super Admin access to set this up. If you're not the admin, share this guide with whoever is and complete the steps together.

Your Google admin will need to:

1. Enable the Admin SDK API in your Google Cloud Console. Go to APIs & Services > Library, search for Admin SDK API, and click Enable.

2. Make sure the person connecting the integration has User Read privileges in Google Workspace. To check, go to Users > [User Name] > View Privileges, scroll to Users, and confirm Read is checked.

If read privileges aren't enabled, you'll see this error during setup: Authorization Error: Error 400: admin_policy_enforced. Simply enable the privilege and try again.

Setting up the integration

1. In Visitly, go to Integrations Hub > Employee Directory.

2. Find Google Workspace and click Connect.
   
   
   

3. Select the Google account that has admin permissions.

4. You may see an "unverified app" warning from Google — this is expected. Since Visitly uses the Google Directory API directly, it is not listed on the Google Workspace Marketplace. Click Advanced, then Go to Visitly to continue.

5. Review the permissions requested and click Allow to grant access.

Once connected, Visitly will sync all employees from your Google Workspace directory automatically. You can also trigger an immediate sync anytime by clicking Sync Now.

What gets synced

Visitly pulls the following employee details from Google Workspace:

Any updates to these fields in Google Workspace will carry over to Visitly on the next sync cycle.

Keeping your directory up to date

• Automatic sync runs every 24 hours — any additions, edits, or removals in Google Workspace will be reflected in Visitly automatically.

• Manual sync is available anytime from the integration settings if you need an immediate update.

• Manually added employees (like contractors or temps) can coexist alongside synced employees and won't be affected by the sync.

Need help?
If you run into any issues during setup, reach out to our support@visitly.io and team and we'll be happy to help.