addTabularRecords

Purpose

You can use the addTabularRecords method to add tabular information to a particular record.

Type: POST

URL Format 

https://recruit.zoho.com/recruit/private/xml/Module/addTabularRecords?authtoken=<authtoken>&id=<id>&xmlData=<XML Data>&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
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 which has to be inserted to a record

Note: Parameters marked with * are mandatory.

Supported Modules

Candidates, JobOpenings, Interviews, Contacts, Clients, All custom modules 

Sample Request

https://recruit.zoho.com/recruit/private/xml/Candidates/addTabularRecords?authtoken=abbdd****&id=368078000001395033&xmlData=<?xml version="1.0"
encoding="UTF-8"?>
<Candidates>

<FL val="Educational Details">
<TR no="0">

<TL val="Institute / School"><![CDATA[Test Institute ]]></TL>
<TL val="Degree"><![CDATA[B.Tech]]></TL>
<TL val="Duration_From"><![CDATA[01-2036]]></TL>
<TL val="Duration_To"><![CDATA[01-2050]]></TL>

</TR> </FL> 

<FL val="Experience Details">
<TR no="0">

<TL val="Occupation / Title"><![CDATA[test]]</TL>
<TL val="Company"><![CDATA[Test]]</TL>
<TL val="Summary"><![CDATA[Test]]></TL>
<TL val="Work Duration_From"><![CDATA[01-1955]]></TL>
<TL val="I currently work here"><![CDATA[false]]></TL>

</TR> </FL> 

<FL val="Tabular 5">
<TR no="0">

<TL val="Label 3"><![CDATA[test]]></TL>

<TL val="Date Range_To"><![CDATA[09/03/2017]]></TL>
</TR>

</FL>
</Candidates>

Response

<?xml version="1.0" encoding="UTF-8"?>
<response uri="/recruit/private/xml/Candidates/addTabularRecords">

<result>
<Candidates>Record(s) added successfully</Candidates>

</result>
</response>

Note:

1. You can add up to a maximum of 10 tabular entries for each record.
   
2. Use CDATA while sending data to recruit if the content contains any special characters to avoid failure of the add/update operation due to XML parsing error
   
3. The addTabularRecords API overwrites any existing tabular data that the record contains.
   
4. To add two or more values to multi picklist fields, use semicolon (;) as the separator.
   Example: <![CDATA[Option 1;Option 2;Option 3]]>

• 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 ...