Zoho RecruitInstall

Overview

This node operation deletes one or more candidate records from Zoho Recruit, a recruitment management platform. It is useful when you want to remove outdated, duplicate, or irrelevant candidate data from your Zoho Recruit database programmatically within an n8n workflow.

Typical scenarios include:

• Cleaning up candidate records after a hiring process is complete.
• Removing candidates who no longer meet job requirements.
• Automating data hygiene by deleting multiple candidates in bulk.

For example, you can provide a comma-separated list of candidate IDs to delete them all at once, optionally triggering any configured workflow rules in Zoho Recruit upon deletion.

Properties

Output

The output JSON contains the response from the Zoho Recruit API for the delete operation. Typically, this includes confirmation of which candidate records were deleted and any status messages returned by the API.

No binary data is produced by this operation.

Example output JSON structure might look like:

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

Dependencies

• Requires an OAuth2 API credential configured for Zoho Recruit with appropriate permissions to delete candidate records.
• The node uses the Zoho Recruit REST API endpoint corresponding to the region of the OAuth token.
• No additional external dependencies beyond the configured Zoho Recruit API credentials.

Troubleshooting

• Invalid Candidate IDs: Ensure that the candidate IDs provided are valid and numeric as expected by Zoho Recruit. Invalid or malformed IDs may cause the API call to fail.
• API Authentication Errors: If authentication fails, verify that the OAuth2 credentials are correctly set up and have not expired. Re-authenticate if necessary.
• Exceeded Maximum IDs: The API limits deletion to a maximum of 100 candidate IDs per request. Providing more than 100 IDs will likely result in an error.
• Workflow Trigger Issues: If enabling workflow triggers causes unexpected behavior, try disabling the "Trigger Workflow" option to isolate the issue.
• Network or API Errors: Check network connectivity and Zoho Recruit service status if requests time out or return server errors.

Common error messages:

• "Candidates deleted successfully" indicates success.
• Authentication-related errors suggest reconfiguring credentials.
• Validation errors indicate issues with input parameters.

Links and References

• Zoho Recruit API Documentation - Candidates
• Zoho Recruit API Authentication
• n8n OAuth2 Credential Setup