Zoho RecruitInstall

Overview

This node allows users to delete notes in Zoho Recruit, a recruitment management platform. It supports deleting either a single note by its ID or multiple notes at once by providing a list of IDs. This functionality is useful for cleaning up outdated or irrelevant notes associated with candidates, jobs, or clients within Zoho Recruit.

Common scenarios:

• Removing a mistakenly created note.
• Bulk deleting notes related to a specific project or candidate batch.
• Automating cleanup of notes after a recruitment campaign ends.

Practical example:

• Delete a single note by specifying its unique numeric ID.
• Delete multiple notes by providing a comma-separated list of numeric note IDs and confirming the bulk deletion action.

Properties

Output

The output is an array of JSON objects representing the response from the Zoho Recruit API for each deletion request. For successful deletions, the response typically contains confirmation data from the API. If errors occur, error details are included in the output JSON.

Example output structure for a single deletion might look like:

{
  "json": {
    "data": [
      {
        "code": "SUCCESS",
        "details": {},
        "message": "Record deleted successfully",
        "status": "success"
      }
    ]
  }
}

For bulk deletions, the output includes the combined API response for all specified note IDs.

Dependencies

• Requires an API key credential configured for Zoho Recruit OAuth2 authentication.
• The node uses Zoho Recruit's REST API endpoints under the base URL https://recruit.zoho.com (or regional variants based on the OAuth token).
• Proper OAuth2 credentials must be set up in n8n to authenticate requests.
• Network access to Zoho Recruit API endpoints is required.

Troubleshooting

• Missing Note ID(s):
  Error thrown if the required note ID(s) are not provided for deletion. Ensure that the "Single Note ID" or "Note IDs" fields are filled appropriately.

• Invalid Note ID format:
  Note IDs must be numeric strings. Non-numeric IDs will cause an error. Verify that IDs contain only digits.

• Bulk deletion confirmation missing:
  When deleting multiple notes, the "Confirm Bulk Deletion" property must be set to true. Otherwise, the node throws an error to prevent accidental mass deletion.

• API Authentication Errors:
  If the OAuth token is invalid or expired, the node will fail. Re-authenticate the Zoho Recruit credentials in n8n.

• Network or API errors:
  Check network connectivity and Zoho Recruit API status. Review error messages returned by the API for further diagnosis.

Links and References

• Zoho Recruit API Documentation
• Zoho OAuth2 Authentication Guide
• n8n Documentation - Creating Custom Nodes