Zoho People icon

Zoho People

Consume Zoho People API
Join our community

Actions8

Overview

This node interacts with the Zoho People API, specifically targeting the "View" resource and the "Fetch View of a Specific Form" operation. It allows users to retrieve all available views (such as default and custom views) for a specific form within their Zoho People account. This is useful when you want to programmatically access or list the different ways data can be presented for a given form—helpful for automation, reporting, or integration scenarios.

Practical Example:
Suppose you have a "Leave Application" form in Zoho People and want to fetch all its associated views (e.g., "All Applications", "Pending Approvals"). This node operation will return those view definitions, which you can then use in subsequent workflow steps.

Properties

Name Type Meaning
Form Link Name String The unique link name (identifier) of the form whose views you want to fetch. Required.

Output

The output is a JSON object (or array of objects) representing the views associated with the specified form. Each object typically contains details about a single view, such as its name, ID, type, and other metadata as provided by the Zoho People API.

Example Output Structure:

[
  {
    "viewName": "All Records",
    "viewId": "1234567890",
    "type": "default",
    // ...other fields depending on Zoho's API response
  },
  {
    "viewName": "Pending Approval",
    "viewId": "0987654321",
    "type": "custom"
  }
]

Note: The exact fields depend on Zoho People API's response.

Dependencies

  • Zoho People Account: You must have an active Zoho People account.
  • API Credentials: Requires OAuth2 credentials configured in n8n under ZohoPeopleOAuth2Api.
  • n8n Configuration: No additional configuration required beyond credential setup.

Troubleshooting

  • Common Issues:

    • Invalid Form Link Name: If the provided "Form Link Name" does not exist, the API will likely return an error indicating the form was not found.
    • Authentication Errors: If OAuth2 credentials are missing or expired, authentication errors will occur.
    • Insufficient Permissions: The connected Zoho account must have permission to access the specified form and its views.

  • Error Messages & Resolutions:

    • "Form not found": Double-check the "Form Link Name" for typos or ensure the form exists in your Zoho People account.
    • "Invalid authentication" or "Unauthorized": Reconnect or refresh your Zoho People OAuth2 credentials in n8n.
    • "Insufficient permissions": Ensure your Zoho user has access rights to the form.

Links and References

Discussion