Zoho Recruit icon

Zoho Recruit

Interact with Zoho Recruit API
Join our community

Actions25

Overview

This node integrates with the Zoho Recruit API to manage candidate records within a recruitment workflow. Specifically, the "Update Candidate" operation allows users to update existing candidate information in Zoho Recruit by specifying the candidate's unique ID and providing new data fields.

Common scenarios for this node include:

  • Keeping candidate profiles up-to-date with the latest contact details, employment status, or skills.
  • Automating updates to candidate records after receiving new information from external sources or forms.
  • Synchronizing candidate data between Zoho Recruit and other HR or recruitment systems.

For example, you might use this node to update a candidate’s current employer and expected salary after an interview or to correct contact information automatically when it changes.

Properties

Name Meaning
Candidate ID The unique identifier of the candidate record to update.
Candidate Data A collection of candidate attributes to update, including:
- 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 (number)
- 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 (number)
- Skill Set: Candidate's skill set

All fields inside "Candidate Data" are required when performing the update.

Output

The output is a JSON object representing the response from the Zoho Recruit API after updating the candidate. It typically includes confirmation of the update and may contain the updated candidate data or status messages.

Example structure of the output JSON (simplified):

{
  "data": [
    {
      "id": "candidate_id",
      "City": "Updated City",
      "Current_Employer": "Updated Employer",
      "Email": "updated.email@example.com",
      ...
    }
  ]
}

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, .eu, .in).
  • Proper network access to Zoho Recruit API endpoints is necessary.

Troubleshooting

  • Missing or invalid Candidate ID: Ensure the Candidate ID provided exists in Zoho Recruit and is correctly formatted.
  • Incomplete Candidate Data: All fields in the candidate data collection are required; missing any will cause errors.
  • Authentication errors: If the OAuth token is expired or invalid, re-authenticate the credentials.
  • API rate limits or connectivity issues: Network problems or API limits can cause failures; check logs and retry as needed.
  • Error responses from Zoho Recruit: The node throws errors if the API returns error messages; review the error details for corrective action.

Links and References

Discussion