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

# Zoho People

> How to set up the Zoho People connector, plus the actions that are available.

![Zoho People](https://stackone-logos.com/api/zoho-people/filled/svg)

v1.1.0[See changelog](https://docs.stackone.com/connectors/zohopeople/changelog.md)

[73 actions](#actions) · 1 auth method

HRIS

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/zohopeople/guides/connector-profile/oauth-2-0.md)
>
> Connect your Zoho People account securely using OAuth 2.0 authorization. Access tokens expire after 1 hour and refresh a...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/zohopeople/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Scopes

Select all
|
Clear

ZOHOPEOPLE.attendance.ALL

ZOHOPEOPLE.forms.ALL

ZOHOPEOPLE.forms.CREATE

ZOHOPEOPLE.forms.READ

ZOHOPEOPLE.forms.UPDATE

ZOHOPEOPLE.leave.ALL

ZOHOPEOPLE.leave.READ

ZOHOPEOPLE.leave.UPDATE

ZOHOPEOPLE.timetracker.CREATE

ZOHOPEOPLE.timetracker.DELETE

ZOHOPEOPLE.timetracker.READ

ZOHOPEOPLE.timetracker.UPDATE

No scopes found

73 actions

ActionDescriptionRequired scopes

Check In`zohopeople_checkin`

Record an attendance check-in for a specific employee at a given time, with optional location tracking via map configura...

`ZOHOPEOPLE.attendance.ALL`

Check Out`zohopeople_checkout`

Record an attendance check-out for an employee to complete the daily work hours entry, requiring a prior check-in

`ZOHOPEOPLE.attendance.ALL`

Single Attendance Record - User Report`zohopeople_get_single_attendance_report`

Get a day-by-day attendance SUMMARY report for ONE employee over a date range (status, total hours, overtime, deviation)...

`ZOHOPEOPLE.attendance.ALL`

Multiple Attendance Records - User Report`zohopeople_get_multiple_attendance_report`

Get a day-by-day attendance report for ALL employees ORGANIZATION-WIDE (100 per page) over a date range. Cannot be scope...

`ZOHOPEOPLE.attendance.ALL`

Get Attendance Entries`zohopeople_get_attendance_entries`

Retrieve RAW check-in/check-out punch entries (timestamps, locations) for a specific date, optionally for one employee....

`ZOHOPEOPLE.attendance.ALL`

Get Employee Shift Details`zohopeople_get_shift_details_of_employee`

Retrieve shift configuration details of an employee for a given date range, including shift timings, holidays, and weeke...

`ZOHOPEOPLE.attendance.ALL`

Bulk Import Attendance`zohopeople_bulk_import_attendance`

Import attendance check-in and check-out records for multiple employees in a single batch API call

`ZOHOPEOPLE.attendance.ALL`

Fetch Latest Attendance Entries`zohopeople_fetch_last_attendance_entries`

Fetch attendance entries added or updated within the last N minutes, including regularisation entries. The canonical act...

`ZOHOPEOPLE.attendance.ALL`

Update Employee Shift`zohopeople_update_employee_shift`

Map or update the shift assigned to an employee for a specified date range

`ZOHOPEOPLE.attendance.ALL`

Get Regularization Records`zohopeople_get_regularization_records`

Fetch attendance regularization request records within a date range, optionally filtered by employee or fetched by recor...

`ZOHOPEOPLE.attendance.ALL`

List Requested Cases`zohopeople_get_requested_cases`

Retrieve HR cases that the authenticated user personally submitted (requested), with optional status filtering. Does NOT...

`ZOHOPEOPLE.forms.READ`

List My Assigned Cases`zohopeople_get_my_cases`

Retrieve HR cases where the authenticated user is the ASSIGNED AGENT (responsible for resolving), with optional filterin...

`ZOHOPEOPLE.forms.READ`

List Unassigned Cases`zohopeople_get_unassigned_cases`

Retrieve HR cases that have NO assigned agent (unassigned queue). Use this to find cases waiting for someone to pick the...

`ZOHOPEOPLE.forms.READ`

List Open Cases`zohopeople_get_open_cases`

Retrieve HR cases in an OPEN state that are relevant to the authenticated user (combines submitted and assigned). Broade...

`ZOHOPEOPLE.forms.READ`

List All Cases`zohopeople_get_all_cases`

Retrieve ALL HR cases across the entire organization regardless of who submitted or is assigned, with full filtering by...

`ZOHOPEOPLE.forms.READ`

View Case`zohopeople_view_case`

Retrieve full details of a specific HR case by its record ID, including status, category, comments, and resolution infor...

`ZOHOPEOPLE.forms.READ`

Create Case`zohopeople_add_case`

Submit a new HR case with a category, subject, and optional description for employee service requests

`ZOHOPEOPLE.forms.CREATE`

List Case Categories`zohopeople_list_case_categories`

Retrieve all HR case categories configured in the organization, providing category IDs needed for creating new cases

`ZOHOPEOPLE.forms.READ`

List Clients`zohopeople_get_clients`

Retrieve a paginated list of all clients configured in the time tracker module

`ZOHOPEOPLE.timetracker.READ`

Get Client Details`zohopeople_get_client_details`

Retrieve full details of a specific client by its ID, including optional record deletion permission info

`ZOHOPEOPLE.timetracker.READ`

Add Client`zohopeople_add_client`

Create a new client in the time tracker module with name, currency, and optional contact details, address, industry clas...

`ZOHOPEOPLE.timetracker.CREATE`

Modify Client`zohopeople_modify_client`

Modify an existing client's name, contact details, address, industry classification, currency, or billing configuration

`ZOHOPEOPLE.timetracker.UPDATE`

Delete Client`zohopeople_delete_client`

Delete one or more clients from the time tracker module by their IDs

`ZOHOPEOPLE.timetracker.DELETE`

Add Employee`zohopeople_add_employee`

Add a new employee to Zoho People with required fields (EmployeeID, FirstName, LastName, EmailID) and optional profile/d...

`ZOHOPEOPLE.forms.CREATE`

Update Employee`zohopeople_update_employee`

Modify an existing employee's field values by record ID

`ZOHOPEOPLE.forms.UPDATE`

Fetch Forms`zohopeople_fetch_forms`

Retrieve all system and custom forms configured in the Zoho People account, including their metadata and view details

`ZOHOPEOPLE.forms.READ`

Get Fields Of Form`zohopeople_get_fields_of_form`

Retrieve the field schema (labelnames, types, mandatory flags, picklist values) of a form. Needed ONLY before insert\_rec...

`ZOHOPEOPLE.forms.READ`

Get Records`zohopeople_get_records`

Retrieve paginated raw records from a Zoho People FORM VIEW (viewName like P\_EmployeeView) -- a GENERIC fallback. Use th...

`ZOHOPEOPLE.forms.READ`

Fetch Single Record`zohopeople_fetch_single_record`

Fetch ONE record with all field values by formLinkName + recordId. Use when you already have a recordId (from get\_record...

`ZOHOPEOPLE.forms.READ`

Insert Record`zohopeople_insert_record`

Insert a new record into any Zoho People form by providing form-specific field values as a JSON-encoded string

`ZOHOPEOPLE.forms.CREATE`

Update Record`zohopeople_update_record`

Modify field values of a specified record in any Zoho People form

`ZOHOPEOPLE.forms.UPDATE`

Default And Custom View`zohopeople_default_and_custom_view`

List all view names and IDs across Zoho People forms -- a discovery step needed ONLY as a prerequisite to get\_records. S...

`ZOHOPEOPLE.forms.READ`

Get Bulk Records`zohopeople_get_bulk_records`

Retrieve all records from a Zoho People FORM (using formLinkName like "employee"), grouped by section. Use get\_records i...

`ZOHOPEOPLE.forms.READ`

List Jobs`zohopeople_list_jobs`

Retrieve jobs assigned to a specific employee with optional filtering by assigner, status, project, and client

`ZOHOPEOPLE.timetracker.READ`

Add Job`zohopeople_add_job`

Create a new job in the time tracker module with name, dates, project assignment, and assignee configuration

`ZOHOPEOPLE.forms.CREATE`

Update Job`zohopeople_update_job`

Modify an existing job's name, dates, project assignment, assignees, or other field values

`ZOHOPEOPLE.forms.UPDATE`

Get Job Details`zohopeople_get_job_details`

Retrieve full details of a specific job by its ID, including optional date formatting and department information

`ZOHOPEOPLE.timetracker.READ`

Modify Job Status`zohopeople_modify_job_status`

Change the status of a job to In-Progress or Completed

`ZOHOPEOPLE.timetracker.UPDATE`

Delete Job`zohopeople_delete_job`

Delete one or more jobs from the time tracker module by their IDs

`ZOHOPEOPLE.timetracker.DELETE`

Get Job Schedule`zohopeople_get_job_schedule`

Retrieve job schedule entries within a date range (max 1 week). Use user="all" to view all users' schedules (specific em...

`ZOHOPEOPLE.timetracker.READ`

Add Job Schedule`zohopeople_add_job_schedule`

Create a NEW job schedule entry for a specific job, date, and time range, with optional repeat configuration. Does NOT p...

`ZOHOPEOPLE.timetracker.CREATE`

Edit Job Schedule`zohopeople_edit_job_schedule`

Modify an existing job schedule entry including date, time, description, repeat settings, and publish status

`ZOHOPEOPLE.timetracker.UPDATE`

Delete Job Schedule`zohopeople_delete_job_schedule`

Delete a job schedule entry, with optional control over repeat series deletion

`ZOHOPEOPLE.timetracker.DELETE`

Publish Job Schedule`zohopeople_publish_job_schedule`

Publish EXISTING (already-created, unpublished) job schedule entries within a date range, making them visible to assigne...

`ZOHOPEOPLE.timetracker.UPDATE`

List Leave Types`zohopeople_list_leave_types`

(DEPRECATION WARNING) Retrieve leave type definitions for a specific employee, including type IDs, names, balance, and p...

`ZOHOPEOPLE.leave.READ`

List Leave Records`zohopeople_list_leave_records`

Retrieve leave request records within a mandatory date range, with optional filtering by employee, approval status, leav...

`ZOHOPEOPLE.leave.READ`

Get User Report`zohopeople_get_user_report`

Retrieve the current-leave-year balance summary for ONE employee. NOT for multi-employee, department, or booked-vs-balan...

`ZOHOPEOPLE.leave.READ`

Get Leave Booked And Balance Report`zohopeople_get_leave_booked_and_balance_report`

Retrieve per-leave-type BOOKED (used) days plus remaining BALANCE for one or more employees over a date range. The canon...

`ZOHOPEOPLE.leave.READ`

Cancel Leave`zohopeople_cancel_leave`

Cancel an existing leave request by its record ID with an optional reason

`ZOHOPEOPLE.leave.UPDATE`

Add Leave Balance`zohopeople_add_leave_balance`

Add or subtract leave balance for employees by providing balance data as a JSON-encoded string

`ZOHOPEOPLE.leave.ALL`

Get All Holidays (V2)`zohopeople_get_all_holidays_v2`

Retrieve holidays with optional filtering by location, shift, employee, and date range (V2 API, replaces deprecated list...

`ZOHOPEOPLE.leave.ALL`

Add Candidate`zohopeople_add_candidate`

Add a new onboarding candidate to the organization with required first name, last name, email, and mobile number

`ZOHOPEOPLE.forms.CREATE`

Update Candidate`zohopeople_update_candidate`

Modify field values of a specific onboarding candidate by their record ID

`ZOHOPEOPLE.forms.UPDATE`

Reopen Onboarding`zohopeople_reopen_onboarding`

Reopen the onboarding process for a candidate using their email or candidate ID

`ZOHOPEOPLE.forms.ALL`

Trigger Employee Onboarding`zohopeople_trigger_onboarding_employee`

Trigger the onboarding process for an existing employee by their record ID

`ZOHOPEOPLE.forms.ALL`

Trigger Candidate Onboarding`zohopeople_trigger_onboarding_candidate`

Trigger the onboarding process for an existing candidate by their record ID

`ZOHOPEOPLE.forms.ALL`

List Timesheet Projects`zohopeople_get_projects`

Retrieve all time tracking projects with optional filtering by client, assignee, status, manager, and project name searc...

`ZOHOPEOPLE.timetracker.READ`

Get Project Details`zohopeople_get_project_details`

Retrieve full details of a specific time tracking project by its ID, including optional user count, job count, and depar...

`ZOHOPEOPLE.timetracker.READ`

Add Project`zohopeople_add_project`

Create a new time tracking project with name, client, users, managers, and optional cost and department configuration

`ZOHOPEOPLE.forms.CREATE`

Update Project`zohopeople_update_project`

Modify an existing project's name, client, users, managers, cost, or department configuration

`ZOHOPEOPLE.forms.UPDATE`

Change Project Status`zohopeople_change_project_status`

Change the status of a time tracking project to In-progress or Completed

`ZOHOPEOPLE.timetracker.UPDATE`

Delete Project`zohopeople_delete_project`

Delete one or more time tracking projects by their IDs

`ZOHOPEOPLE.timetracker.DELETE`

List Timesheets`zohopeople_get_timesheets`

Retrieve timesheet entries with optional filtering by user, approval status, employee status, and date range

`ZOHOPEOPLE.timetracker.READ`

Add Time Log`zohopeople_add_time_log`

Create a new time log entry for a specific employee against a job with date, hours, and optional billing and project det...

`ZOHOPEOPLE.timetracker.CREATE`

List Time Logs`zohopeople_list_time_logs`

Retrieve time log entries with optional filtering by user, job, date range, client, project, billing status, and approva...

`ZOHOPEOPLE.timetracker.READ`

Get Time Log Details`zohopeople_get_time_log_details`

Retrieve full details of a specific time log entry by its ID, including optional timer details and comment count

`ZOHOPEOPLE.timetracker.READ`

Edit Time Log`zohopeople_edit_time_log`

Modify an existing time log entry -- requires re-sending workDate, jobId, billingStatus, and hours on every call even if...

`ZOHOPEOPLE.timetracker.UPDATE`

Delete Time Log`zohopeople_delete_time_log`

Permanently delete one or more time log entries by their IDs

`ZOHOPEOPLE.timetracker.DELETE`

Get Timesheet Details`zohopeople_get_timesheet_details`

Retrieve full details of a specific timesheet by its ID, including time entries, approval status, and total hours

`ZOHOPEOPLE.timetracker.READ`

Create Timesheet`zohopeople_create_timesheet`

Create a new timesheet for a specific employee with a defined date range, and optionally associate it with jobs, project...

`ZOHOPEOPLE.timetracker.CREATE`

Approve Timesheet`zohopeople_approve_timesheet`

Approve or reject a submitted timesheet, with optional comments and control over multi-level approval

`ZOHOPEOPLE.timetracker.UPDATE`

Modify Timesheet`zohopeople_modify_timesheet`

Modify an existing timesheet's name, description, submission status, or remove attachments

`ZOHOPEOPLE.timetracker.UPDATE`

Delete Timesheet`zohopeople_delete_timesheet`

Permanently delete one or more timesheets by their IDs

`ZOHOPEOPLE.timetracker.DELETE`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.