Zoho Recruit icon

Zoho Recruit

Interact with Zoho Recruit API

Actions25

Overview

This node interacts with the Zoho Recruit API to manage notes within the Zoho Recruit system. Specifically, the "Note" resource with the "Get" operation retrieves a single note by its unique ID. This is useful when you need to fetch detailed information about a specific note attached to candidates, jobs, or clients in your recruitment workflow.

Practical examples include:

  • Retrieving a note's content and metadata for display or processing in an automated hiring pipeline.
  • Fetching notes to synchronize data between Zoho Recruit and other HR or CRM systems.
  • Using note details to trigger conditional logic in workflows based on note content or associations.

Properties

Name Meaning
Note ID The unique identifier of the note to retrieve. It must be provided to fetch the specific note.

Output

The output contains a JSON object representing the retrieved note from Zoho Recruit. The structure typically includes fields such as the note's title, content, parent record ID, module type (e.g., Candidates, Jobs, Clients), creation and modification timestamps, and any other metadata provided by the Zoho Recruit API for notes.

Example output JSON structure (simplified):

{
  "data": [
    {
      "Note_Title": "Example Note Title",
      "Note_Content": "Detailed content of the note.",
      "Parent_Id": "1234567890",
      "se_module": "Candidates",
      "Created_Time": "2023-01-01T12:00:00Z",
      "Modified_Time": "2023-01-02T15:30:00Z",
      "id": "9876543210"
    }
  ]
}

No binary data is output for this operation.

Dependencies

  • Requires an OAuth2 API credential configured for Zoho Recruit to authenticate API requests.
  • The node uses the Zoho Recruit REST API endpoint, which varies depending on the region (e.g., .com, .com.au, .eu, .in, .cn).
  • Proper network access to Zoho Recruit API endpoints is necessary.

Troubleshooting

  • Missing or invalid Note ID: The node requires a valid numeric Note ID. If the ID is missing or incorrectly formatted, the node will throw an error.
  • Authentication errors: If the OAuth2 token is expired or invalid, API calls will fail. Re-authenticate the credentials in n8n.
  • API rate limits or connectivity issues: Network problems or Zoho API rate limiting can cause failures. Check API status and retry later.
  • Error responses from Zoho API: The node surfaces errors returned by Zoho Recruit, including permission issues or non-existent note IDs.

Links and References

Discussion