# Connecting Google Workspace to iCompaas

- Source: https://support.icompaas.com/support/solutions/articles/a_gen_ss_62000037934_104dac2620-connecting-google-workspace-to-icompaas
- Section: [Solutions](https://support.icompaas.com/support/solutions) › [Getting Started With iCompaas](https://support.icompaas.com/support/solutions/62000037934) › [Personnel Onboarding](https://support.icompaas.com/support/solutions/folders/personnel-onboarding)
- Last updated: 2026-07-15
- Publisher: iCompaas, Inc. (https://www.icompaas.com)

Estimated time: 5 minutes · requires: a Google Workspace administrator account that can consent to directory read access

### What this connection does

Personnel onboarding syncs your people directory into iCompaas so you can track who has access, who is an admin, and whether 2-step verification is enabled and enforced — evidence your auditors ask for. The connection is authorised through Google's own consent screen with a single read-only scope (`admin.directory.user.readonly`); iCompaas never sees your password and never gets write access.

### Connect the source

1.  In the app, open _Onboarding → Personnel onboarding_ (or go to _Account → Personnel_) and click **Add source → Google Workspace**.
2.  Enter a **Source label** (3–60 characters, e.g. _Engineering Directory_) — a friendly name to identify this source in your dashboard.
3.  Click **Save & authorize**. An authorization popup opens — **allow pop-ups from the iCompaas site** if your browser asks.
4.  Sign in with a Google Workspace administrator account and approve the read-only access.
5.  Personnel sync begins automatically — the source moves from _Awaiting auth_ to _Syncing_ and then _Synced_.

### What gets synced

Names, primary and recovery email, phone number, admin status, 2FA enabled/enforced flags, suspension state and employment type. Use _View personnel list_ to see the synced people.

### Managing the source

-   **Sync now** — trigger a manual re-sync from the source's row actions.
-   **Edit** — only the label can be changed. To re-authorize, remove the source and add it again.
-   **Remove** — stops future syncs; existing personnel data remains until the next sync cycle.

### Troubleshooting

-   **"Popup was blocked"** — allow pop-ups for the iCompaas site and click _Save & authorize_ again.
-   **Source stuck on _Awaiting auth_** — the OAuth window was closed before finishing. Remove the source and add it again.
-   **"Google OAuth configuration missing"** — contact support; this is a configuration issue on our side, not yours.