Zoho People icon

Zoho People

Consume Zoho People API
Join our community

Actions8

Overview

The Zoho People node for n8n, when configured with the Attendance resource and the Fetch Last Attendance Entries operation, retrieves the most recent attendance entries from Zoho People. This is useful for organizations that want to automate the extraction of recent employee attendance data for reporting, monitoring, or integration with other HR systems.

Practical examples:

  • Automatically fetch the last 5 days of attendance records every morning and send a summary email to HR.
  • Integrate with payroll systems to ensure up-to-date attendance data is available for salary calculations.
  • Trigger alerts if certain employees have missing or irregular attendance in the recent period.

Properties

Name Type Meaning
Duration Number The number of days (or time units as defined by Zoho API) to look back for attendance entries. Determines how many recent entries are fetched.
Date Time Format String The format in which date and time values should be returned in the output. Follows standard date-time formatting patterns.

Output

The node outputs a JSON array where each item represents an attendance entry fetched from Zoho People. The exact structure of each entry depends on the Zoho People API response, but typically includes fields such as:

{
  "employeeId": "string",
  "checkInTime": "string",
  "checkOutTime": "string",
  "status": "string",
  // ...other attendance-related fields
}
  • Each object contains details about an employee's attendance within the specified duration.
  • The date and time fields will follow the format specified in the Date Time Format property.

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 OAuth2 credential is set up in your n8n instance.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the OAuth2 credentials are incorrect or expired, the node will throw authentication errors. Re-authenticate or refresh the credentials.
  • API Limitations: Exceeding Zoho API rate limits may result in errors; check your Zoho account's API usage.
  • Incorrect Property Values: Supplying an invalid value for "Duration" or an unsupported "Date Time Format" can cause API errors. Refer to Zoho People API documentation for supported formats.
  • Error Handling: If Continue On Fail is enabled, failed items will return an object with an error field containing the error message.

Example Error Message:

{ "error": "Invalid OAuth token" }

Resolution: Check and update your Zoho People OAuth2 credentials in n8n.

Links and References

Discussion