# Connecting Zoho Workspace to iCompaas

- Source: https://support.icompaas.com/support/solutions/articles/a_gen_ss_62000037934_735e68a60f-connecting-zoho-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 Zoho administrator account for the organisation

### What this connection does

Syncs your Zoho organisation's people directory into iCompaas so you can track accounts, admin status and 2FA posture for compliance evidence. Authorisation happens on Zoho's own consent screen with read-only scopes (`ZohoMail.organization.accounts.READ`, `ZohoMail.partner.organization.READ`) — no passwords are shared and no write access is granted.

### Connect the source

1.  In the app, open _Onboarding → Personnel onboarding_ and click **Add source → Zoho**.
2.  Enter a **Source label** (3–60 characters) — 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 Zoho administrator account and approve the 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.
-   **"Zoho OAuth configuration missing"** — contact support; this is a configuration issue on our side, not yours.