Zoho RecruitInstall

Overview

This node interacts with the Zoho Recruit API to retrieve multiple note types configured in a Zoho Recruit account. The "Get Many" operation for the "Note Type" resource fetches a list of note types, which are categories or classifications used to organize notes within Zoho Recruit.

Typical use cases include:

• Synchronizing note type data from Zoho Recruit into other systems.
• Displaying available note types for selection in workflows.
• Automating processes that depend on specific note type categorizations.

For example, a recruiter might want to pull all note types to dynamically populate a dropdown menu in a form or to filter notes by their type in an automated report.

Properties

Output

The output JSON contains an array of note type objects under the note_types field. Each object represents a note type as defined in Zoho Recruit, including its properties such as ID, name, and any other metadata provided by the API.

The node does not output binary data for this operation.

Example output structure (simplified):

{
  "note_types": [
    {
      "id": "123456789",
      "name": "Interview Notes",
      "description": "Notes related to candidate interviews"
      // ... other fields ...
    },
    {
      "id": "987654321",
      "name": "Client Feedback",
      "description": "Notes capturing client feedback"
      // ... other fields ...
    }
  ],
  "info": {
    "page": 1,
    "per_page": 50,
    "count": 2,
    "more_records": false
  }
}

Dependencies

• Requires an OAuth2 API credential for Zoho Recruit to authenticate requests.
• The node uses the Zoho Recruit API endpoint, which varies based on the region of the OAuth token (e.g., .com, .com.au, .eu, etc.).
• No additional external dependencies beyond the n8n environment and the configured Zoho Recruit OAuth2 credentials.

Troubleshooting

• Authentication errors: Ensure the OAuth2 credentials are valid and have not expired. Re-authenticate if necessary.
• Pagination issues: If "Return All" is enabled but fewer results than expected are returned, verify that the API supports pagination correctly and that the node is configured to handle multiple pages.
• Invalid parameter values: For example, setting non-numeric values for page or perPage options may cause errors.
• API rate limits: Zoho Recruit API may enforce rate limits; excessive requests could result in temporary blocking.
• Empty results: Confirm that note types exist in the Zoho Recruit account and that the authenticated user has permission to access them.

Links and References

• Zoho Recruit API Documentation - Note Types
• Zoho Recruit Official Site
• n8n Documentation - Creating Custom Nodes