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
- In the app, open Onboarding → Personnel onboarding (or go to Account → Personnel) and click Add source → Google Workspace.
- Enter a Source label (3–60 characters, e.g. Engineering Directory) — a friendly name to identify this source in your dashboard.
- Click Save & authorize. An authorization popup opens — allow pop-ups from the iCompaas site if your browser asks.
- Sign in with a Google Workspace administrator account and approve the read-only access.
- 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.
- “Access blocked” by your Google Workspace organization — your organization’s app access policies may require an administrator to approve iCompaas:
- Sign in to admin.google.com with a Super Admin account.
- Go to Security → Access and data control → API controls → Manage App Access (or Manage Third-Party App Access).
- Click Configure new app and search for iCompaas. If it does not appear, contact iCompaas support for its OAuth Client ID.
- Select the app and choose the organizational unit containing the administrator account used for the integration.
- Click Continue, select Trusted, then click Continue → Finish.
- Retry the connection in iCompaas. If the source remains on Awaiting auth, remove it and add it again.
Policy changes may take up to 24 hours to apply. Trusted permits broad access to Google services; the personnel connection itself requests only the read-only directory permission described above. See Google’s app access guidance.
If a menu option is not where described, use the Admin console search bar to find API controls.