associateJobOpening

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

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 

ParameterData TypeDescription
jobIds*StringSpecify uniqueID of the Job Opening record.
candidateIds*StringSpecify candidate ids separated by comma to associate with the above jobIds.
version*IntegerUse version=2: This will fetch responses based on the latest API implementation
statusStringSpecify the status of the Candidate with the associated Job opening.
By default, "Associated" will be the status on association.
commentsStringSpecify the comments for the association.

Note: Parameters marked with * are mandatory.

Example

To associate Job Opening in Zoho Recruit using third-party applications.
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>

    • Related Articles

    • API Methods

      Method Name Purpose getRecords To retrieve all users data specified in the API request getRecordById To retrieve individual records by record ID addRecords To insert records into the required Zoho Recruit module updateRecords To update or modify the ...