# Zoho People — HRIS API: overview

> Canonical URL: https://developers.apideck.com/apis/hris/zoho-people/overview

Zoho People is an online HR management software which helps you automate all your HR processes efficiently.
- Status: live
- Authentication: oauth2

- **apideck credentials note:** For testing only; production connections use your own Zoho OAuth client.
- **webhooks:** Virtual webhooks - employee created, updated and terminated events
- **beta:** false
- **rate limits:** Per day by plan: 5,000 (Essential HR), 10,000 (Professional), 15,000 (Premium), 25,000 (Enterprise); 250 calls per user licence, 500 on Enterprise.
- **account type required:** Zoho People account on Essential HR or higher.
- **difficulty reason:** Self-Service OAuth Client + Free Trial, No Partnership or App Review
- **consumer access level:** Zoho People publishes no minimum role for authorising a connection.
- **authentication note:** Authorization Code flow.
- **sandbox url:** https://www.zoho.com/people/signup.html
- **difficulty:** straightforward
- **environment notes:**   - **environment:** Single environment
  - **description:** Testing and production use the same OAuth client and credentials. Test with a 30-day free trial account to keep test activity away from live employee records.
- **sandbox note:** 30-day free trial with all plan features; Zoho People's in-product Sandbox (a copy of your configuration) is an Enterprise plan feature.
- **sandbox available:** true
- **partnership required:** false
- **important to know:** Each Zoho People account sits in one regional data centre. Consumers pick theirs when connecting, and your Zoho OAuth client must be enabled for every data centre your consumers use, or their authorisation fails.
- **supported resource categories:**   - **name:** People
  - **resources:** employees
  - **name:** Company Structure
  - **resources:** departments
  - **name:** Compensation
  - **resources:** salaries
- **responsibility matrix:**   - **area:** Create the OAuth client in the Zoho API console (server-based)
  - **customer:** ✓
  - **customer:** ✓
  - **area:** Enable each data centre and reuse the credentials across them
  - **area:** Add client ID, secret and scopes in the Apideck Dashboard
  - **customer:** ✓
  - **area:** Authorise access and choose the regional domain in Vault
  - **consumer:** ✓
  - **apideck:** ✓
  - **area:** Store tokens and refresh access tokens
- **costs:** API included with Essential HR and higher paid plans; Zoho publishes no separate API fee.
- **partnership note:** Zoho runs no partner programme or app review for API access.
- **apideck credentials available:** true
- **external guides:**   - **source:** Zoho
  - **title:** Zoho People API documentation
  - **url:** https://www.zoho.com/people/api/overview.html

## Supported resources

- **custom field support:** false
- **downstream id:** employees
- **name:** Employees
- **id:** employees
- **downstream name:** Employees
- **status:** live
- **downstream id:** departments
- **downstream name:** Departments
- **status:** live
- **name:** Departments
- **id:** departments
- **custom field support:** false

An omitted operation list does not establish operation support. Verify the selected operation in the coverage matrix.

[API reference](https://developers.apideck.com/apis/hris/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/hris/coverage)
