associateJobOpening
Purpose
You can use this method to associate candidates to job openings in Zoho Recruit.
Note: Use the POST method to pass these parameters instead of GET method.
Request URL
XML Format:
https://recruit.zoho.com/recruit/private/xml/Candidates/associateJobOpening?authtoken=AuthToken&scope=recruitapi
JSON Format:
https://recruit.zoho.com/recruit/private/json/Candidates/associateJobOpening?authtoken=AuthToken&scope=recruitapi
For OAuth Authentication
| Header Name |
Value |
| Authorization |
Zoho-oauthtoken {access_token} |
Scopes
Scope=ZohoRecruit.modules.all
(or)
Scope=ZohoRecruit.modules.{scope_name}.{operation_type}
| Possible Scope Names (Case Sensitive) |
Operation Types |
|
associatejobopening
|
ALL - Full access to the record READ - Get records from the module |
For Authtoken Authentication
| Parameter |
Data Type |
Description |
| authtoken* |
String |
Encrypted alphanumeric string to authenticate your Zoho credentials. |
| scope* |
String |
Specify the value as recruitapi |
Request Parameters
| Parameter | Data Type | Description |
| jobIds* | String | Specify uniqueID of the Job Opening record. |
| candidateIds* | String | Specify candidate ids separated by comma to associate with the above jobIds. |
| version* | Integer | Use version=2: This will fetch responses based on the latest API implementation |
| status | String | Specify the status of the Candidate with the associated Job opening. By default, "Associated" will be the status on association. |
| comments | String | Specify the comments for the association. |
Note: Parameters marked with * are mandatory.
Example
To associate Job Opening in Zoho Recruit using third-party applications.
URL Format:
https://recruit.zoho.com/recruit/private/xml/Candidates/associateJobOpening?authtoken=AuthToken&scope=recruitapi&jobIds=292114000000087156
&candidateIds=292114000000139404,292114000000139403
Response Format:
<response uri="/recruit/private/xml/Candidates/associateJobOpening">
<result>
<message>Candidate(s) associated successfully</message>
<recorddetail>
<FL val="jobIds">
292114000000087156,292114000000087140,292114000000087124
</FL>
<FL val="candidateIds">292114000000139404,292114000000139403</FL>
</recorddetail>
</result>
</response>
<result>
<message>Candidate(s) associated successfully</message>
<recorddetail>
<FL val="jobIds">
292114000000087156,292114000000087140,292114000000087124
</FL>
<FL val="candidateIds">292114000000139404,292114000000139403</FL>
</recorddetail>
</result>
</response>