We are trying to attach files to a Candidate in Zoho Recruit using the API.

We reviewed the following API documentation:
🔗 Upload Attachment

While this API does allow file attachment via a URL, that’s not what we want — we do not want to attach public-facing documents. The documentation mentions that it's possible to upload a file in the request body, but it doesn't provide any examples or details on the expected format of the body when sending a file directly.

We also looked into this endpoint:
🔗 Import Document

Again, the same issue: there’s no clear explanation of how to associate the document with a specific Candidate or what exact information should be included in the request.

We are building this integration using Deluge, and unfortunately, the two integrated tasks for file upload (uploadFile and uploadDocument) are only available in Zoho Creator, not in Zoho Recruit workflows or custom functions.

We’d really appreciate it if Zoho could clarify:

• How to attach a non-public file directly (not using a URL) using the API.

• What the expected format of the request body is for file upload.

• How to correctly associate the document with a Candidate record.