Associate Candidate

Purpose

To associate a candidate with a job opening.

Request URL

https://recruit.zoho.com/recruit/v2/Candidates/actions/associate

Request Method

PUT

Scope

scope= ZohoRecruit.modules.all
(or)
scope=ZohoRecruit.modules.candidate.UPDATE
(or)
scope=ZohoRecruit.modules.candidate.ALL

Possible module names	Possible operation types
candidate and jobopening	ALL - Full access to the record READ - Get records from the module

Possible Errors

Error Code	Message
ALREADY_ASSOCIATED	The candidate is already associated with a job.
MANDATORY_NOT_FOUND	Mandatory input parameters are missing.
RECORD_LOCKED	No actions can be performed on a locked record. Unlock and try again.
INVALID_DATA	The given candidate ID is invalid.
BLOCKED_RECORD	The record is either restricted or the candidate has opted-out.
ID_ALREADY_DELETED	The candidate record has been deleted.
SUCCESS	The candidate has been successfully associated.
FAILURE	The candidate hasn't been associated. Review the Candidate and Job Opening IDs used.

Sample Request

Copiedcurl "https://recruit.zoho.com/recruit/v2/Candidates/actions/associate"
-X PUT
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Sample Input

Copied{
   "data": [
    {
      "jobids": ["100001000000025015","100001000000025001"],
      "ids": ["100001000000027011","100001000000027002"],
      "comments":"Record successfully associated"
     }
   ]
 }

Sample Response

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "jobid": "100001000000025001",
                "ids": "[100001000000027002, 100001000000027011]"
            },
            "message": "Record associated successfully",
            "status": "success"
        },
        {
            "code": "SUCCESS",
            "details": {
                "jobid": "100001000000025015",
                "ids": "[100001000000027002, 100001000000027011]"
            },
            "message": "Record associated successfully",
            "status": "success"
        }
    ]
}