> For the complete documentation index, see [llms.txt](https://docs.siit.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siit.io/integrations/hris/zoho-people.md).

# Zoho People

<figure><img src="/files/iYpsJtzigiNVZcudaW3N" alt=""><figcaption></figcaption></figure>

### What you get

* **Live People directory** — Zoho People employees appear in Siit with role, manager, department, and lifecycle dates.
* **Lifecycle triggers** — Date of joining, Date of exit, Work anniversary, and Birthday flow into Siit as workflow triggers.
* **Manager resolution** — Zoho People's reporting structure powers auto‑selected approvers in workflows.
* **Pre‑hires** — future employees with a date of joining in Zoho People appear in Siit ahead of Day 1.

### What syncs from Zoho People

| Category        | Fields                                         |
| --------------- | ---------------------------------------------- |
| Identity        | First name, last name, work email, employee ID |
| Role            | Designation (job title), department            |
| Org structure   | Reporting manager, location, legal entity      |
| Employment      | Employment type, status                        |
| Lifecycle dates | Date of joining, date of exit, date of birth   |

Work email is the canonical identifier across systems.

### Before you connect

* A Zoho People admin with permission to authorize third‑party apps.
* Work email populated for every active employee in Zoho People.
* Note your Zoho data center region (zoho.com, zoho.eu, zoho.in, etc.) — Siit needs the right region during connect.

### Connect Zoho People

1. In Siit, go to **Settings → Integrations**, find **Zoho People** in the HRIS section, and click **Connect**.
2. Pick your Zoho data center region.
3. Sign in with your Zoho admin account and approve the requested read scopes.
4. Review the imported people and field mapping, then click **Finish setup**.

Need a more detailed walkthrough? Reach out to support via the in‑app chat.

### After the connection

* Confirm your **People list** matches Zoho People's active workforce.
* In **Settings → People → Fields**, set Zoho People as the source of truth for HR‑owned fields if you're also connected to an IdP.
* Build a Day‑1 onboarding workflow using the Date of joining trigger.

### Sync frequency

Zoho People data refreshes automatically every few hours. Trigger an immediate refresh from **Settings → Integrations → Zoho People → Sync now**.

### Common workflows

**Day‑1 onboarding.** *Trigger: Date of joining. Actions: create IdP account, assign apps by department, ship equipment, DM reporting manager.*

**Offboarding on exit.** *Trigger: Date of exit. Actions: revoke sessions, remove app access, equipment pickup, notify reporting manager.*

### Troubleshooting

**Employees missing.** Only active employees and future hires sync by default. Confirm status and work email in Zoho People.

**Wrong data center region.** Disconnect and reconnect with the correct region for your Zoho tenant.

**Manager field empty.** In Zoho People, check the employee has a reporting manager assigned.

**Connection shows "needs reauthorization".** Reconnect from **Settings → Integrations → Zoho People**.