Zoho Recruit icon

Zoho Recruit

Interact with Zoho Recruit API
Join our community

Actions25

Overview

This node interacts with the Zoho Recruit API to update an existing note record. It allows users to modify details such as the note's title, content, parent record ID, and the module type of the parent record (e.g., Candidates, Jobs, Clients). This operation is useful in scenarios where notes attached to various records in Zoho Recruit need to be edited or corrected after creation.

Practical examples include:

  • Updating a candidate's note to add additional information or correct errors.
  • Changing the parent record association of a note if it was linked incorrectly.
  • Modifying the content or title of a note to reflect new developments or feedback.

Properties

Name Meaning
Note ID The unique identifier of the note to update.
Note Title The updated title of the note.
Note Content The updated content/body text of the note.
Parent ID The ID of the parent record (such as a candidate, job, or client) that the note belongs to.
SE Module The module type of the parent record. Options: Candidates, Jobs, Clients.

Output

The output is a JSON object representing the response from the Zoho Recruit API after updating the note. It typically contains the updated note data or confirmation of the update operation.

Example structure of the json output field:

{
  "data": [
    {
      "Note_Title": "Updated Title",
      "Note_Content": "Updated content here...",
      "Parent_Id": "1234567890",
      "se_module": "Candidates",
      "id": "9876543210"
    }
  ]
}

No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential for Zoho Recruit to authenticate API requests.
  • The node uses the Zoho Recruit REST API endpoint, which varies based on the region of the OAuth token.
  • Proper configuration of the OAuth2 credentials in n8n is necessary for successful authentication and authorization.

Troubleshooting

  • Missing Note Data: If no update data is provided, the node throws an error indicating that note data is required.
  • Empty Update Fields: If all fields in the update data are empty or undefined, the node throws an error stating that at least one field must be provided for the update.
  • Invalid Note ID: If the Note ID is missing or invalid, the API call will fail; ensure the Note ID is correctly specified.
  • Authentication Errors: If the OAuth token is expired or invalid, the node will fail to authenticate. Re-authenticate the Zoho Recruit credentials in n8n.
  • API Rate Limits: Frequent updates may hit Zoho API rate limits; consider adding delays or handling retries accordingly.

Links and References

Discussion