Zoho RecruitInstall

Overview

This node interacts with the Zoho Recruit API to manage photos associated with Candidates or Contacts. Specifically, the "Download a Photo" operation allows users to download a photo for a specified Candidate or Contact record by providing the record ID and module type.

Common scenarios where this node is beneficial include:

• Retrieving candidate or contact photos stored in Zoho Recruit for use in other systems or workflows.
• Automating the process of fetching profile images for display in dashboards or reports.
• Integrating Zoho Recruit photos into external HR or recruitment platforms.

Example: A recruiter wants to automatically download and save candidate photos from Zoho Recruit to a local database or cloud storage as part of an onboarding workflow.

Properties

Output

The output contains the downloaded photo data in binary form along with metadata:

• json: An empty JSON object {} (no additional JSON data returned).
• binary.data: Contains the photo file encoded in base64 format, including:
  • data: Base64-encoded image content.
  • fileName: The filename extracted from the response headers or generated as photo_<RecordID>.
  • mimeType: The MIME type of the image (e.g., image/png, image/jpeg).

This binary output can be used downstream in n8n workflows to save the photo to disk, upload it elsewhere, or process it further.

Dependencies

• Requires an OAuth2 API credential configured for Zoho Recruit with appropriate permissions to access Candidate or Contact photos.
• The node makes authenticated HTTP requests to the Zoho Recruit API endpoints.
• No additional external dependencies beyond standard n8n helper methods and Node.js Buffer handling.

Troubleshooting

• No file data received from photo download: Indicates that the API did not return any photo data. Verify the Record ID and Module are correct and that the photo exists.
• Zoho OAuth token not found: Means the OAuth2 credentials are missing or expired. Re-authenticate the Zoho Recruit credentials in n8n.
• Invalid Record ID: Ensure the Record ID is correctly provided and corresponds to an existing Candidate or Contact.
• Unexpected response content: If the response appears to be HTML or JSON error instead of image data, check API limits, permissions, or if the record has a photo uploaded.
• Binary property missing: For upload operations (not applicable here), ensure the binary property name matches the input data.

Links and References

• Zoho Recruit API Documentation
• Zoho Recruit Photos API Reference
• n8n OAuth2 Credential Setup