Help Center
Open app
Help CenterIntegrationsConnect Zoho People

Integrations

Connect Zoho People

How to connect Zoho People so Doow can map your employees to departments, teams, and reporting structures.

Connecting Zoho People lets Doow map your workforce to departments and teams, which unlocks department-level spend breakdowns, per-team utilisation reports, and cost-centre allocation. Doow requests read-only access and never modifies your Zoho People data.

What Doow reads from Zoho People

When you connect Zoho People, Doow pulls:

  • Employee directory — name, work email, employee ID, status (active/inactive), and date of joining
  • Department and designation — department, job title, and reporting manager from each employee profile
  • Employment type — full-time, part-time, contractor status

Doow does not read: compensation, salary, attendance, leave records, performance appraisals, or documents stored in Zoho People.

Before you start

You need:

  • A Zoho People account with Administrator privileges
  • Your Zoho People domain (e.g. acmecorp from acmecorp.zohopeople.com)
  • Access to the Zoho API Console to generate an OAuth client

Step 1 — Create an OAuth client in Zoho

  1. Sign in to the Zoho API Console.
  2. Click Add Client and select Self Client.
  3. Enter a name (e.g. "Doow integration").
  4. For Scopes, add: ZOHOPEOPLE.organization.READ, ZOHOPEOPLE.forms.READ, ZOHOPEOPLE.sections.READ.
  5. Click Create.
  6. From the client details page, copy the Client ID and Client Secret.

Step 2 — Generate the grant token

  1. In your browser, visit (replacing {client_id} and {domain} with your values):

    https://accounts.zoho.com/oauth/v2/auth?scope=ZOHOPEOPLE.organization.READ,ZOHOPEOPLE.forms.READ,ZOHOPEOPLE.sections.READ&client_id={client_id}&response_type=code&access_type=offline&redirect_uri=https://app.doow.co/integrations/zoho-people/callback

  2. Sign in and approve the requested scopes.

  3. You are redirected to Doow with a code parameter in the URL. Copy the full URL.

Step 3 — Enter the details in Doow

  1. In Doow, go to Settings → Integrations.
  2. Click Connect integration and select Zoho People.
  3. Enter your Zoho People domain (subdomain from your Zoho People URL).
  4. Paste the Client ID and Client Secret.
  5. Paste the full redirect URL (with the code parameter).
  6. Click Connect.

Doow exchanges the code for access and refresh tokens, validates the connection, and begins an initial sync. The first sync typically takes 2–5 minutes.

Step 4 — Verify the mapping

Once the sync completes:

  1. Go to the Dashboard and add the Department spend breakdown widget.
  2. Confirm it shows your departments and headcounts from Zoho People.
  3. Go to Applications → any app → Usage tab — the department column should show department names from Zoho People.

If departments are missing or mapped incorrectly, contact support — the department mapping from Zoho People to Doow's internal format is configured on Doow's side.

Data refresh

Zoho People syncs once every 24 hours. Changes in Zoho People are reflected in Doow within a day. To force an immediate sync, go to Settings → Integrations → Zoho People and click Sync now.

Token expiry and renewal

Zoho OAuth access tokens are short-lived. Doow automatically refreshes them using the refresh token. If the refresh token expires (typically after extended disuse), the integration card shows Reauthorisation required. Click Reconnect and repeat Step 2 to generate a new grant token.

Disconnecting Zoho People

  1. Go to Settings → Integrations.
  2. Find the Zoho People integration card and click the menu (three dots).
  3. Select Disconnect and confirm.

Historical department data is preserved. New data shows "Unknown" for department until you reconnect or connect a different HRIS.

To revoke access from the Zoho side: go to the Zoho API Console, find the Doow client, and click Revoke.