Zoho Recruit

Manage Zoho Recruit candidates and job openings.

Attach an internal note to a candidate for collaboration.

Parameters

Parameter	Type	Required	Description
`candidate_id`	string	No	ID of the candidate receiving the note.
`note`	string	No	Note content to attach to the candidate.

Response

{
  "candidate_id": "12345",
  "note": "Interview scheduled.",
  "note_id": "67890"
}

Link a candidate to an open job to track their application.

Parameters

Parameter	Type	Required	Description
`candidate_id`	string	No	Existing candidate ID to associate.
`job_id`	string	No	Job opening ID the candidate should be linked to.

Response

{
  "candidate_id": "12345",
  "job_id": "67890"
}

Add a new candidate record with contact information.

Parameters

Parameter	Type	Required	Description
`first_name`	string	No	Candidate's first name.
`last_name`	string	No	Candidate's last name.
`email`	string	No	Primary email address for the candidate.
`phone`	string	No	Optional phone number for the candidate.

Response

{
  "candidate_id": "12345",
  "email": "jane@example.com",
  "first_name": "Jane",
  "last_name": "Doe"
}

Retrieve Zoho Recruit job openings with optional status filters.

Parameters

Parameter	Type	Required	Description
`status`	string	No	Optional status filter such as Open or On Hold.
`page`	number	No	Page number of results to fetch (defaults to 1).
`per_page`	number	No	Number of jobs per page (defaults to 20).

Response

{
  "jobs": [
    {}
  ],
  "status": "mock_value"
}

Change the stage or status for a Zoho Recruit candidate.

Parameters

Parameter	Type	Required	Description
`candidate_id`	string	No	ID of the candidate to update.
`status`	string	No	New status value, such as Interview or Offer.

Response

{
  "candidate_id": "12345",
  "status": "Interview"
}