Zoho People icon

Zoho People

Consume Zoho People API

Leave → Add Leave

AI-generated

Summary

Create a new leave record for an employee in Zoho People with specified leave details.

Inputs

  • Form Link Name (required) — Form label name (usually 'leave') identifying the leave form.
  • Employee ID (required) — Unique identifier of the employee for whom the leave record is created.
  • Leave Type ID (required) — Identifier for the type of leave being recorded.
  • From Date (required) — Start date of the leave period.
  • To Date (required) — End date of the leave period.
  • Leave Type (required) — Specifies if the leave is day-based or hour-based.
  • Days Configuration (JSON) (required) — JSON object detailing leave specifics per date. For day-based leave, specify leave count (e.g., full, half-day) and session. For hour-based leave, specify leave count as duration and start/end times.

Output shape

a single record representing the created leave entry

The output is a JSON object confirming the created leave record with submitted details. Errors are returned if creation fails.

Examples

Example 1: Add a day-based half-day leave on 07-Jan-2021

Form Link Name: 'leave'; Employee ID: 'E123'; Leave Type ID: 'LT456'; From Date: '07-Jan-2021'; To Date: '07-Jan-2021'; Leave Type: 'day'; Days Configuration: '{"07-Jan-2021":{"LeaveCount":0.5,"Session":2}}'

Discussion