> ## Documentation Index
> Fetch the complete documentation index at: https://docs.antei.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> Step-by-step guide to connecting your Zoho People account to Antei securely and reliably.

<Icon icon="sign-post" size={22} color="#4B5563" />

# Zoho People – Integration Setup

This guide outlines how to securely connect Zoho People with Antei to enable automated syncing of employee data for jurisdictional and compliance mapping.

***

<Icon icon="lock" size={22} color="#4B5563" />

## Authentication Method

Antei uses **OAuth 2.0** to connect to Zoho People with read-only access.

* **Type:** OAuth 2.0 (Authorization Code Flow)
* **Scopes Requested:**
  * Read-only access to employee directory metadata
* **Data Usage:** Used to map entities, determine jurisdiction, and support HR-linked tax workflows
* **Security:** Tokens are encrypted and all access is scoped per organization

> 🔐 Antei is SOC 2 compliant. No modifications are made to your Zoho People data.

***

<Icon icon="link" size={22} color="#4B5563" />

## Step-by-Step Setup

### 1. Navigate to Integrations → Zoho People

In the Antei dashboard, go to **Integrations** and click **Connect Zoho People**.

![Connect Zoho People Button](https://via.placeholder.com/800x200?text=Connect+Zoho+People+Button)

***

### 2. Authorize Access via Zoho

You’ll be redirected to Zoho’s OAuth consent screen. Select your Zoho People account and approve read-only employee access.

![Zoho People OAuth Consent](https://via.placeholder.com/800x400?text=Zoho+People+OAuth+Consent+Screen)

***

### 3. Configure Sync Filters

Post-authentication, customize:

* **Filter logic** – Sync only active employees or specific departments
* **Jurisdiction mapping** – Auto-link employees to countries/entities
* **Sync window** – Option to fetch data from past 3, 6, or 12 months

![Zoho People Sync Settings](https://via.placeholder.com/800x300?text=Zoho+People+Sync+Settings)

> ✅ Only metadata is used. Salary and private details are never accessed.

***

## Verification & Testing

Antei validates connection with:

* ✅ Employee profile fetch
* ✅ Jurisdictional rule test
* ✅ Sync status log under **Settings → Logs**

***

## FAQs

<Icon icon="help-circle" size={18} color="#4B5563" />

**What employee fields does Antei pull?**\
Name, email, status, department, designation, and location — all scoped for compliance workflows.

**Does Antei access sensitive HR data?**\
No. Salary, benefits, and payroll information are never requested.

**Can I disconnect Zoho People?**\
Yes — disconnect anytime from Antei or revoke access from Zoho’s connected apps dashboard.

***

## Need Help?

Email us at [tech@antei.com](mailto:tech@antei.com).\
→ View the [Zoho People Integration Scope](/integrations/ZohoPeople/ZohoPeopleData) for more details.