Add Records in Zoho Recruit

 Overview

The zoho.recruit.addRecord() task can be executed to add a record in any of the supported modules of Zoho Recruit. By placing it in the required form actions block of Zoho Creator, the process of adding records in Zoho Recruit can easily be automated as per requirement. Lets say you have a Zoho Creator form which is used to submit details of a recruited candidate. To add the details simultaneously in our Zoho Recruit’s "Candidates" module, you can execute zoho.recruit.addRecord() task in the “On Success” form actions block. This will create a record in Zoho Recruit whenever the Zoho Creator form is submitted with candidate’s details. Further details on how to execute this task are explained below.

 Supported Modules

  • Candidates
  • Job Openings
  • Clients
  • Client Contacts

 Syntax

response = zoho.recruit.addRecord(moduleName, dataMap, duplicateCheck)

where,
<response> - is the map variable returned by Zoho Recruit as response. 
<moduleName> - name of module in Zoho Recruit where the record will be added. (mandatory)
<dataMap> - map variable that holds the key,value pairs. The map key is the label name as specified in Zoho Recruit module and the map value is the field value as submitted in the ZC form. For example, "First Name" : input.First_Name . Here, "First Name" is the the label name as specified in Zoho Recruit module and input.First_Name refers to the value specified in the First_Name field in the Zoho Creator form. (mandatory)
<duplicateCheck>(optional) - An int value, set “1” to search if the record already exists, “2” to update the record if exists. If either true or false is not set then the record will be added as a new record. (optional)

 Example

Following is a sample script that can be added in a Zoho Creator form to create a new record in Zoho Recruit . Let's say we have a Creator form containing fields, "First Name", "Last Name", "Email" and "Work Phone". You can add the following script to On Add -> On Success block of the Creator Form so that whenever this form is submitted, a record is created in Zoho Recruit's specified module with specified details. In this case, the module is "Candidates".

response = zoho.recruit.addRecord("Candidates", "First name" : input.First_Name, "Last name" : input.Last_Name, "Email" : input.Email, "Work Phone" : "9876");

where,
response - is the map variable returned by Zoho Recruit as response. 
Candidates - name of module in Zoho Recruit where the record will be added.
"First Name", "Last Name", "Email" and "Work Phone" are Form fields and their corresponding values follow afer a colon.

 Response

Response returned by Zoho Recruit as map:

{"message":"Record(s) added successfully","Created Time":"2015-11-19 18:04:55","Modified By”:”john”,”Id":"1687000000116001","Modified Time":"2015-11-19 18:04:55","Created By”:”john”}