Zoho People icon

Zoho People

Consume Zoho People API
Join our community

Actions8

Overview

The Zoho People node for n8n, when configured with the "Leave" resource and the "Get Leave Types" operation, retrieves the available leave types for a specified user from the Zoho People API. This is useful in HR automation workflows where you need to fetch or display the types of leaves (such as sick leave, vacation, etc.) that a particular employee is eligible for.

Practical examples:

  • Automatically listing all leave types for an employee before submitting a leave request.
  • Integrating with other systems to synchronize leave type information.
  • Displaying available leave types in a custom dashboard or notification.

Properties

Name Type Meaning
User Id String The unique identifier of the user whose leave types are to be retrieved. Required field.

Output

The output will be a JSON object (or array of objects) containing the leave type details for the specified user. The exact structure depends on the Zoho People API response, but typically includes fields such as leave type name, code, description, balance, etc.

Example output:

[
  {
    "leaveTypeId": "12345",
    "leaveTypeName": "Sick Leave",
    "description": "Paid sick leave",
    "balance": 10,
    // ...other fields
  },
  {
    "leaveTypeId": "67890",
    "leaveTypeName": "Casual Leave",
    "description": "General purpose leave",
    "balance": 5
  }
]

Note: The actual keys may vary based on Zoho People API's response.

Dependencies

  • External Service: Requires access to the Zoho People API.
  • Authentication: Needs valid OAuth2 credentials for Zoho People (ZohoPeopleOAuth2Api).
  • n8n Configuration: Ensure the Zoho People credential is set up in your n8n instance.

Troubleshooting

Common issues:

  • Invalid or missing User Id: If the User Id is incorrect or not provided, the API may return an error or empty result.
  • Authentication errors: Invalid or expired OAuth2 tokens will cause authentication failures.
  • API quota limits: Exceeding Zoho API rate limits can result in errors.

Error messages and resolutions:

  • "Invalid userId": Double-check the User Id value; ensure it matches a valid user in Zoho People.
  • "Unauthorized" or similar: Re-authenticate or refresh your Zoho People OAuth2 credentials in n8n.
  • "API limit exceeded": Wait and retry after some time, or check your Zoho People account's API usage.

Links and References

Discussion