Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zoho People Employee API

Employee record CRUD across the People HRIS.

Zoho People Employee API is one of 7 APIs that Zoho People publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Employee. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a JSON-LD context, rate-limit docs, and 1 JSON Schema.

This API exposes 3 operations across 3 paths, and defines 1 schema. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 8 base URLs: https://people.zoho.com/people/api, https://people.zoho.eu/people/api, https://people.zoho.in/people/api, https://people.zoho.com.au/people/api, https://people.zoho.jp/people/api, https://people.zoho.com.cn/people/api, https://people.zohocloud.ca/people/api, https://people.zoho.sa/people/api.

3 operations 3 paths 1 schemas 1 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://people.zoho.com/people/api
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Zoho People Employee API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (ZohoOAuth2) using the authorizationCode flow, exposing 13 scopes. By default, every request must be authenticated.

  • ZohoOAuth2 — Zoho Accounts OAuth 2.0 — Authorization Code grant. Access tokens live for 1 hour; refresh tokens are long-lived until revoked. Scope syntax is ZOHOPEOPLE. . w…

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 1 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Employee 3

Employee record CRUD across the People HRIS.

GET
/forms/employee/getRecords
List Employee Records
listEmployees 1 param → 200
POST
/forms/employee/insertRecord
Create Employee Record
createEmployee body → 200
POST
/forms/employee/updateRecord
Update Employee Record
updateEmployee 1 param body → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is Employee (11 properties). Each schema is shown below with its type and property counts.

Employee
object
11 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-people-employee-api-openapi.yml Raw ↑

Other APIs Zoho People publishes across the network.

Zoho People Attendance API
Zoho People Automation API
Zoho People Dashboard API
Zoho People Forms API
Zoho People Leave API
Zoho People Time Tracker API