Home / API / updateRecords

API

Start FREE Trial

Zoho Recruit API

updateRecords


Purpose

You can use this method to update or modify the records in Zoho Recruit.

Note: This is a POST only API.

Request URL to updateRecords:
XML:
https://recruit.zoho.com/ats/private/xml/Module/updateRecords?authtoken=Auth Token&scope=recruitapi
JSON: https://recruit.zoho.com/ats/private/json/Module/updateRecords?authtoken=Auth Token&scope=recruitapi

Note: Replace Module with any one of this - JobOpenings, Candidates, Clients, ClientContacts.

Request Parameters:


ParameterTypeDescription
authtoken* String Encrypted alphanumeric string to authenticate your Zoho credentials.
scope* String Specify the value as recruitapi
id* String Specify unique ID of the records.
xmlData* XML This is an XML string and the format should be same as of getRecords in XML format of fetched records

* - Mandatory parameter

Duplicate Check Fields:

Module NameDuplicate Check Field
JobOpenings Posting title
Candidates Email ID
Clients Client
ClientContacts Email

Examples:

Update records into Zoho Recruit from third-party applications

URL Format:
https://recruit.zoho.com/ats/private/xml/JobOpenings/updateRecords?authtoken=Auth Token&scope=recruitapi&id=54290000000089027&xmlData=XMLDATA 

XMLDATA JobOpening example:

<JobOpenings>
<row no="1">
<FL val="Posting title">Java Developer</FL>
<FL val="Client">ZOHO</FL>
<FL val="Assigned recruiter">0001</FL>
<FL val="Client manager">0001</FL>
<FL val="Job opening status">In-progress</FL>
<FL val="Number of positions">5</FL>
<FL val="Country">INDIA</FL>
<FL val="Roles and responsibilities">Develop web service with proper data model</FL>
<FL val="Attach doc">TVlTUUwgMTkyLjE2OC4xNS40NCAxOTIuMTY4LjE1Ljk1IDE5Mi4xNjguMTUuNzMKRklMRSAxOTIuMTY4LjE1LjQ0IDE5Mi4xNjguMTUuOTUgMTkyLjE2OC4xNS43MwpCQUNLVVAgMTkyLjE2OC4xNS40NCAxOTIuMTY4LjE1Ljk1IDE5Mi4xNjguMTUuNzMK</FL>
<FL val="Attach doc_filename">components.txt</FL>
</row>
</JobOpenings>

XMLDATA Candidates example:

<Candidates>
<row no="1">
<FL val="First name">Satvik</FL>
<FL val="Last name">Kothandaraman</FL>
<FL val="Contact address">my home</FL>
<FL val="Email ID">satvik@advent.com</FL>
<FL val="Contact number">44987654</FL>
<FL val="Total work exp (year)">5</FL>
<FL val="Total work exp (month)">5</FL>
<FL val="Current job title">SE</FL>
<FL val="Skill set">Java</FL>
<FL val="Resume status">New</FL>
<FL val="Attach resume"> TVlTUUwgMTkyLjE2OC4xNS40NCAxOTIuMTY4LjE1Ljk1IDE5Mi4xNjguMTUuNzMKRklMRSAxOTIuMTY4LjE1LjQ0IDE5Mi4xNjguMTUuOTUgMTkyLjE2OC4xNS43MwpCQUNLVVAgMTkyLjE2OC4xNS40NCAxOTIuMTY4LjE1Ljk1IDE5Mi4xNjguMTUuNzMK</FL>
<FL val="Attach resume_filename">components.txt</FL>
</row>
</Candidates>

The file attachment should be base64encoded and send to us. Along with the name of the file in a separate xml node with fieldlabel_filename as below example:
<FL val="Attach resume"> TVlTUUwgMTkyLjE2OC4xNS40NCAxOTIuMTY4LjE1Ljk1IDE5Mi4xNjguMTUuNzMKRklMRSAxOTIuMTY4LjE1LjQ0IDE5Mi4xNjguMTUuOTUgMTkyLjE2OC4xNS43MwpCQUNLVVAgMTkyLjE2OC4xNS40NCAxOTIuMTY4LjE1Ljk1IDE5Mi4xNjguMTUuNzMK</FL>
<FL val="Attach resume_filename">components.txt</FL>

Response Format:
<response uri="/ats/private/xml/JobOpenings/updateRecords">
<result>
<message>Record(s) updated successfully</message>
<recorddetail>
<FL val="Id">54290000000089027</FL>
</recorddetail>
</result>
</response>

Automate your Recruitment Process

Track Openings, Resumes, Candidates and Clients

Follow us on Twitter
Become a fan on Facebook