Associate Job Opening

Purpose

To associate one or more job opening(s) with a candidate using Widget APIs.

Request Format

ZOHO.RECRUIT.API.associateJobOpening({
"ids": [
"{candidate_id}"
],
"jobids": [
"{job_opening_ids}"
],
"comments": "{comments}"
});

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

CopiedZOHO.RECRUIT.API.associateJobOpening({
    "ids": [
        "14501000001948049"
    ],
    "jobids": [
        "100001000000025001", "14501000001798704"
    ],
    "comments": "Record Associated Successfully"
}).then(function(successResponse) {
   
}, function(failureResponse) {
    
});

Success Response

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