Zoho Recruit icon

Zoho Recruit

Interact with Zoho Recruit API
Join our community

Actions25

Overview

This node interacts with the Zoho Recruit API to manage attachments related to various modules such as Candidates, Clients, Job Openings, and more. Specifically, the Attachment Upload operation allows users to upload one or multiple files as attachments to a specified record within a chosen module in Zoho Recruit.

Typical use cases include:

  • Automatically uploading resumes or other documents to candidate profiles.
  • Adding supporting documents to job openings or client records.
  • Integrating file uploads into recruitment workflows for centralized document management.

For example, you could use this node to upload a candidate's resume stored as binary data in n8n directly to their profile in Zoho Recruit, streamlining the hiring process.

Properties

Name Meaning
Module The Zoho Recruit module where the attachment will be uploaded. Options: Applications, Campaigns, Candidates, Clients, Contacts, Departments, Events, Interviews, Job Openings, Tasks, Vendors.
Record ID The unique numeric identifier of the record within the selected module to which the attachment(s) will be uploaded.
Attachments Category The category label for the attachment (e.g., Resume, Others). This is sent as a query parameter to categorize the uploaded files.
Binary Property Name(s) Comma-separated list of binary property names from the input data that contain the file(s) to upload. For example, "data" or "data,otherFile".

Output

The node outputs an array of JSON objects corresponding to each uploaded file. Each output item contains the response from Zoho Recruit API about the uploaded attachment, including details such as attachment ID, status, or any error information if the upload failed.

The output does not include binary data but provides metadata about the upload result for each file.

Example output JSON snippet for one uploaded file might look like:

{
  "attachmentId": "1234567890",
  "fileName": "resume.pdf",
  "status": "success"
}

If no valid binary files are found for the specified properties, the node outputs an error message indicating missing or invalid binary data.

Dependencies

  • Requires an active OAuth2 API credential for Zoho Recruit with appropriate permissions to upload attachments.
  • The node expects binary data to be present on the input items under the specified binary property names.
  • Network access to Zoho Recruit API endpoints is required.
  • No additional external libraries beyond those bundled with n8n are needed.

Troubleshooting

  • Missing or empty binary data: If the specified binary property names do not exist or contain no data, the node logs warnings and skips those files. Ensure your input data includes valid binary files under the correct property names.
  • Invalid Record ID format: The Record ID must be numeric. Non-numeric IDs will cause errors.
  • Module or Record ID not provided: Both are mandatory; missing these parameters will throw errors.
  • OAuth token issues: If the OAuth token is missing or expired, the node will fail. Re-authenticate the Zoho Recruit credentials in n8n.
  • Upload failures: Errors during file upload are logged, and the error response is included in the output JSON for troubleshooting.
  • Large files or multiple files: Uploading many or large files may take longer; monitor execution timeouts or API rate limits.

Links and References

Discussion