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 Candidate - Create operation allows users to add new candidate profiles into Zoho Recruit by providing detailed candidate information such as personal details, contact info, employment history, skills, and salary expectations.
Typical use cases include:
- Automating the addition of candidates collected from job application forms or other sources directly into Zoho Recruit.
- Integrating external HR systems or databases with Zoho Recruit to keep candidate data synchronized.
- Streamlining recruitment workflows by programmatically creating candidate records without manual entry.
For example, after receiving a candidate's resume via email or a web form, this node can be used to create a corresponding candidate record in Zoho Recruit with all relevant details filled in automatically.
Properties
| Name | Meaning |
|---|---|
| City | City where the candidate is located |
| Current Employer | The current employer of the candidate |
| Current Salary | Candidate's current salary (number) |
| Candidate's email address | |
| Expected Salary | Candidate's expected salary (number) |
| Experience in Years | Number of years of professional experience |
| First Name | Candidate's first name |
| Highest Qualification Held | The highest academic or professional qualification the candidate holds |
| Last Name | Candidate's last name |
| Mobile | Candidate's mobile phone number |
| Notice Period | Notice period in days before candidate can join |
| Skill Set | List or description of candidate's skills |
These properties are grouped under a fixed collection named Candidate Data and are all required for the create operation.
Output
The output JSON contains the response from the Zoho Recruit API after attempting to create the candidate record. It typically includes:
- Confirmation of the created candidate record.
- The unique ID assigned to the candidate by Zoho Recruit.
- Any additional metadata returned by the API about the newly created candidate.
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 endpoint, which varies based on the region of the OAuth token (e.g.,
.com,.com.au,.eu,.in,.com.cn). - Proper network access to Zoho Recruit API endpoints is necessary.
Troubleshooting
- Missing Required Fields: If any required candidate property is missing or empty, the API will reject the request. Ensure all required fields are provided.
- Authentication Errors: If the OAuth2 token is invalid or expired, authentication will fail. Re-authenticate the credentials in n8n.
- API Endpoint Region Mismatch: The base URL changes depending on the OAuth token domain. Using mismatched credentials may cause connection errors.
- Invalid Data Types: Numeric fields like salaries, experience, and notice period must be numbers; strings in these fields may cause errors.
- Network Issues: Connectivity problems to Zoho Recruit API endpoints will result in request failures.