Zoho Recruit | updateTabularRecords Method

updateTabularRecords


Note: If you’re using the new version of APIs (V2), refer this link. 

Purpose
You can use the updateTabularRecords method to update particular tabular entries of a specified record.

Type:  POST

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
referral, campaign, assessment, vendor, offer,  attachment, 
forecast, note, call, event, task,  candidate, jobopening, client, department, interview, contact & custom (for all Custom Modules )
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
id*
String
Specify the unique ID of the record
xmlData* 
XML
Tabular data to be updated to a record


Note: Parameters marked with * are mandatory
Sample Request
https://recruit.zoho.com/recruit/private/xml/Candidates/updateTabularRecords?authtoken=<authtoken>&id=<candidateid>&xmlData=<?xml version="1.0" encoding="UTF-8"?> <Candidates><FL val="Experience Details"><TR no="0"><TL val="TABULARROWID"><![CDATA[368078000002922007]]></TL><TL val="Occupation /Title"genType="1"uiType="1"><![CDAT A[Ja va Developer - Mooresville, NC]]></TL><TL val="Company" genType="1" uiType="1"><![CDATA[Lowe's]]></TL><TL val="Summary" genType="1" uiType="110"><![CDATA[test]]></TL><TL val="Work Duration_From" genType="1" uiType="6607"><![CDATA[01-2015]]></TL><TL val="I currently work here" 
genType="1" uiType="301"><![CDATA[false]]></TL></TR></FL></Candidates> 
Response
<?xml version="1.0" encoding="UTF-8"?>
<response uri="/recruit/private/xml/Candidates/updateTabularRecords"> 
<result>
<Candidates>Record(s) updated successfully</Candidates> 
</result> </response> 

Note:
  1. If there isn't any record with matching with the specified tabular row id, the data will be treated as new and will be added as a tabular entry along with the existing data.
  2. To update two or more values on to multi picklist fields, use semicolon (;) as the separator.
    Example: <![CDATA[Option 1;Option 2;Option 3]]>