Zoho Recruit icon

Zoho Recruit

Interact with Zoho Recruit API
Join our community

Actions25

Overview

This node operation deletes an attachment from a specified record within Zoho Recruit. It is useful when you need to programmatically remove files associated with various modules such as Candidates, Clients, Job Openings, or other entities managed in Zoho Recruit.

Typical use cases include:

  • Cleaning up outdated or incorrect attachments linked to records.
  • Automating the removal of attachments after certain workflow steps.
  • Managing storage by deleting unnecessary files.

For example, if you have a Candidate record with an obsolete resume attached, this node can delete that specific attachment by specifying the module, record ID, and attachment ID.

Properties

Name Meaning
Module The Zoho Recruit module where the attachment belongs. Options: Applications, Campaigns, Candidates, Clients, Contacts, Departments, Events, Interviews, Job Openings, Tasks, Vendors.
Record ID The unique numeric identifier of the record (e.g., candidate, client) from which the attachment will be deleted. Must be a numeric string.
Attachment ID The unique numeric identifier of the attachment to delete. Must be a numeric string.

Output

The output JSON contains the response from the Zoho Recruit API after attempting to delete the attachment. Typically, this includes confirmation of deletion or error details if the operation failed.

No binary data is output for this operation since it only performs deletion.

Example output JSON structure:

{
  "status": "success",
  "message": "Attachment deleted successfully"
}

or in case of failure:

{
  "status": "error",
  "message": "Attachment not found or could not be deleted"
}

Dependencies

  • Requires an OAuth2 API credential configured for Zoho Recruit to authenticate API requests.
  • The node uses Zoho Recruit's REST API endpoints, so internet access and valid credentials are necessary.
  • No additional external services are required beyond Zoho Recruit.

Troubleshooting

  • Missing Required Parameters: The node requires Module, Record ID, and Attachment ID. Omitting any will cause errors.
  • Invalid ID Format: Both Record ID and Attachment ID must be numeric strings. Non-numeric values will trigger validation errors.
  • Authentication Errors: If the OAuth token is missing or expired, the node will fail. Re-authenticate the Zoho Recruit credentials.
  • Attachment Not Found: If the specified attachment does not exist under the given record and module, the API will return an error.
  • API Rate Limits: Excessive calls may hit Zoho API rate limits; handle such errors by retrying after some delay.

Common error messages:

  • "Module, Record ID, and Attachment ID are required for attachment deletion": Ensure all three parameters are provided.
  • "Invalid record ID format. Record ID should be numeric.": Check that the Record ID contains only digits.
  • "Invalid attachment ID format. Attachment ID should be numeric.": Check that the Attachment ID contains only digits.
  • "Zoho OAuth token not found... Please re-authenticate your credentials.": Refresh or reconfigure the OAuth credentials.

Links and References

Discussion