Zoho PeopleInstall

Overview

The Zoho People custom n8n node, when configured with the Leave resource and the Get Holidays operation, retrieves holiday information for a specified user from the Zoho People API. This is useful in HR automation workflows where you need to fetch company holidays relevant to an employee, such as for leave planning, payroll processing, or calendar synchronization.

Practical Example:
You could use this node to automatically pull a user's holiday list and update their personal calendar, or to check for upcoming holidays before approving leave requests.

Properties

Output

• The output is a JSON object (or array) containing the holiday details as returned by the Zoho People API.
• The structure typically includes fields such as holiday names, dates, and possibly additional metadata, depending on the Zoho API response.
• No binary data is produced by this operation.

Dependencies

• External Service: Requires access to the Zoho People API.
• Authentication: Needs valid OAuth2 credentials for Zoho People (ZohoPeopleOAuth2Api).
• n8n Configuration: The credential must be 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: If the OAuth2 credentials are invalid or expired, you'll receive authentication/authorization errors.
• API Limitations: Hitting Zoho API rate limits may cause temporary failures.

Error Messages & Resolutions:

• "Invalid userId": Double-check that the User Id matches a valid user in Zoho People.
• "Unauthorized" or similar: Ensure your Zoho People OAuth2 credentials are correctly configured and have not expired.
• "Network Error": Check your network connection and ensure n8n can reach the Zoho People API endpoint.

Links and References

• Zoho People API Documentation
• n8n Credentials Setup Guide
• Zoho People Help Center