Zoho People icon

Zoho People

Consume Zoho People API

Overview

The Zoho People node for n8n, when configured with the Forms resource and the Get Record Count operation, retrieves the total number of records present in a specified Zoho People form. This is useful for automating processes that depend on the size or growth of data within a particular form, such as monitoring submissions, triggering actions when thresholds are met, or generating reports.

Practical examples:

  • Automatically alerting HR when a job application form exceeds a certain number of entries.
  • Periodically logging the count of leave requests submitted via a custom form.
  • Triggering workflows based on the volume of feedback received through an internal survey form.

Properties

Name Type Meaning
Form Link Name String The unique link name (identifier) of the Zoho People form whose record count you want to retrieve. This is required.

Output

The output will be a JSON object containing the record count information for the specified form. The structure typically includes:

{
  "response": {
    "result": {
      "count": <number>
    }
  }
}
  • count: The total number of records found in the specified form.

Note: The exact structure may vary depending on the Zoho People API response, but the key information is the record count.

Dependencies

  • External Service: Requires access to the Zoho People API.
  • Authentication: Needs valid ZohoPeopleOAuth2Api credentials configured in n8n.
  • Environment: No special environment variables are needed beyond standard n8n credential setup.

Troubleshooting

Common issues:

  • Invalid Form Link Name: If the provided form link name does not exist, the node will throw an error indicating the form was not found.
  • Authentication Errors: If OAuth2 credentials are missing or expired, you may see errors related to authentication failure.
  • API Limitations: Hitting Zoho API rate limits may result in temporary failures.

Error messages and resolutions:

  • "Form not found": Double-check the "Form Link Name" property for typos or incorrect values.
  • "Invalid authentication": Ensure your Zoho People OAuth2 credentials are correctly set up and have not expired.
  • "Request failed with status code 429": You have hit the API rate limit; try again later or reduce request frequency.

Links and References

Discussion