Zoho People
Overview
Pre-built tooling
✅ Authorization
✅ Authorization
✅ Read & write data
✅ Read & write data
| Tools | Status |
|---|---|
| Pre-built integrations | 🚫 (time to contribute: <48h) |
| API unification | ✅ |
| 2-way sync | ✅ |
| Webhooks from Nango on data modifications | ✅ |
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: <48h) |
| Proxy requests | ✅ |
✅ Observability & data quality
✅ Observability & data quality
| Tools | Status |
|---|---|
| HTTP request logging | ✅ |
| End-to-type type safety | ✅ |
| Data runtime validation | ✅ |
| OpenTelemetry export | ✅ |
| Slack alerts on errors | ✅ |
| Integration status API | ✅ |
✅ Customization
✅ Customization
| Tools | Status |
|---|---|
| Create or customize use-cases | ✅ |
| Pre-configured pagination | ✅ |
| Pre-configured rate-limit handling | 🚫 (time to contribute: <48h) |
| Per-customer configurations | ✅ |
Pre-built integrations
No pre-built integration yet (time to contribute: <48h)
Access requirements
| Pre-Requisites | Status | Comment |
|---|---|---|
| Paid dev account | ✅ Not required | Free Zoho account is sufficient for development. |
| Paid test account | ✅ Not required | Free Zoho account is sufficient for testing. |
| Partnership | ✅ Not required | |
| App review | ✅ Not required | No review process for OAuth apps. |
| Security audit | ✅ Not required |
Setup guide
Follow the general Zoho OAuth setup guide to create your OAuth application. When selecting scopes, make sure to include the People-specific scopes listed in the Common Scopes section below.
Useful links
- Zoho API Console
- Zoho Developer Hub
- OAuth 2.0 Overview
- Server-based Applications
- Get Authorization Code
- Get Access Token
- Refresh Access Token
- Multi DC Support
- OAuth Scopes
People-specific links
Common Scopes
- ZohoPeople.forms.ALL - Access to all People forms
- ZohoPeople.employee.ALL - Access to all employee data
- ZohoPeople.attendance.ALL - Access to all attendance data
- ZohoPeople.leave.ALL - Access to all leave data
- ZohoPeople.timetracker.ALL - Access to all time tracker data
- ZohoPeople.shifts.ALL - Access to all shift data
API gotchas
-
Zoho uses datacenter-specific URLs for authentication. Make sure to use the correct datacenter domain extension (
com,eu,in,com.cn,com.au) based on where your user’s account is registered. -
Zoho has rate limits that vary by service. Check the specific service documentation for details.
-
If your application needs to access multiple Zoho services, you need to request scopes for each service during the authorization process.
-
For production applications, consider implementing multi-datacenter support to handle users from different regions.
People-specific gotchas
- Zoho People API has region-specific endpoints. You need to use the correct endpoint based on the user’s region.
- The People API has rate limits that vary based on your Zoho People plan.
- API rate limits are documented at Zoho People API Limits.
Zoho People
Overview
Pre-built tooling
✅ Authorization
✅ Authorization
✅ Read & write data
✅ Read & write data
| Tools | Status |
|---|---|
| Pre-built integrations | 🚫 (time to contribute: <48h) |
| API unification | ✅ |
| 2-way sync | ✅ |
| Webhooks from Nango on data modifications | ✅ |
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: <48h) |
| Proxy requests | ✅ |
✅ Observability & data quality
✅ Observability & data quality
| Tools | Status |
|---|---|
| HTTP request logging | ✅ |
| End-to-type type safety | ✅ |
| Data runtime validation | ✅ |
| OpenTelemetry export | ✅ |
| Slack alerts on errors | ✅ |
| Integration status API | ✅ |
✅ Customization
✅ Customization
| Tools | Status |
|---|---|
| Create or customize use-cases | ✅ |
| Pre-configured pagination | ✅ |
| Pre-configured rate-limit handling | 🚫 (time to contribute: <48h) |
| Per-customer configurations | ✅ |
Pre-built integrations
No pre-built integration yet (time to contribute: <48h)
Access requirements
| Pre-Requisites | Status | Comment |
|---|---|---|
| Paid dev account | ✅ Not required | Free Zoho account is sufficient for development. |
| Paid test account | ✅ Not required | Free Zoho account is sufficient for testing. |
| Partnership | ✅ Not required | |
| App review | ✅ Not required | No review process for OAuth apps. |
| Security audit | ✅ Not required |
Setup guide
Follow the general Zoho OAuth setup guide to create your OAuth application. When selecting scopes, make sure to include the People-specific scopes listed in the Common Scopes section below.
Useful links
- Zoho API Console
- Zoho Developer Hub
- OAuth 2.0 Overview
- Server-based Applications
- Get Authorization Code
- Get Access Token
- Refresh Access Token
- Multi DC Support
- OAuth Scopes
People-specific links
Common Scopes
- ZohoPeople.forms.ALL - Access to all People forms
- ZohoPeople.employee.ALL - Access to all employee data
- ZohoPeople.attendance.ALL - Access to all attendance data
- ZohoPeople.leave.ALL - Access to all leave data
- ZohoPeople.timetracker.ALL - Access to all time tracker data
- ZohoPeople.shifts.ALL - Access to all shift data
API gotchas
-
Zoho uses datacenter-specific URLs for authentication. Make sure to use the correct datacenter domain extension (
com,eu,in,com.cn,com.au) based on where your user’s account is registered. -
Zoho has rate limits that vary by service. Check the specific service documentation for details.
-
If your application needs to access multiple Zoho services, you need to request scopes for each service during the authorization process.
-
For production applications, consider implementing multi-datacenter support to handle users from different regions.
People-specific gotchas
- Zoho People API has region-specific endpoints. You need to use the correct endpoint based on the user’s region.
- The People API has rate limits that vary based on your Zoho People plan.
- API rate limits are documented at Zoho People API Limits.