Actions25
- Attachment Actions
- User Actions
- Associated Actions
- Candidate Actions
- Note Actions
- Note Type Actions
- Photo Actions
- Profile Actions
- Role Actions
- Status Actions
Overview
This node integrates with the Zoho Recruit API to manage candidate records within a recruitment workflow. Specifically, the "Create or Update" operation for the "Candidate" resource allows users to either create a new candidate record or update an existing one if it already exists (upsert). This is useful in scenarios where you want to ensure that candidate data is synchronized without creating duplicates, such as importing candidates from another system or updating candidate profiles based on new information.
Practical examples include:
- Automatically adding new candidates from a job application form submission.
- Updating candidate details when receiving updated resumes or contact information.
- Synchronizing candidate databases between Zoho Recruit and other HR systems.
Properties
| Name | Meaning |
|---|---|
| Candidate Data | A fixed collection of fields describing the candidate's profile. Includes: |
| - City: City of the candidate | |
| - Current Employer: Candidate's current employer | |
| - Current Salary: Candidate's current salary (number) | |
| - Email: Candidate's email address | |
| - Expected Salary: Candidate's expected salary (number) | |
| - Experience in Years: Number of years of experience | |
| - First Name: Candidate's first name | |
| - Highest Qualification Held: Highest qualification obtained | |
| - Last Name: Candidate's last name | |
| - Mobile: Candidate's mobile phone number | |
| - Notice Period: Notice period in days | |
| - Skill Set: Candidate's skill set |
All these fields are required for the create or update operation.
Output
The node outputs JSON data representing the response from the Zoho Recruit API after performing the create or update operation. The output typically includes details about the candidate record created or updated, such as the candidate ID and any status messages returned by the API.
No binary data is produced by this operation.
Dependencies
- Requires an OAuth2 API credential configured for Zoho Recruit to authenticate API requests.
- The node uses the Zoho Recruit REST API endpoints, which vary depending on the region (e.g., zoho.com, zoho.eu).
- Network access to Zoho Recruit API endpoints is necessary.
Troubleshooting
- Missing Required Fields: All candidate data fields are required. Omitting any will likely cause the API request to fail. Ensure all fields are provided.
- Authentication Errors: If the OAuth2 token is invalid or expired, the node will fail. Re-authenticate the credentials in n8n.
- API Endpoint Region Mismatch: The node determines the API base URL based on the OAuth token URL. If your Zoho Recruit account is in a different region, ensure the correct region is reflected in the credentials.
- Invalid Data Types: Fields like salaries and experience must be numbers. Providing incorrect types may cause errors.
- Network Issues: Connectivity problems to Zoho Recruit API endpoints will cause failures.
Common error messages usually relate to missing fields, invalid authentication tokens, or malformed requests. Reviewing the error message and ensuring all required inputs and valid credentials are provided resolves most issues.