Update record

Update records in Zoho Recruit


The zoho.recruit.updateRecord is used to update a record in Zoho Recruit. This task is based on the Zoho Recruit API - Update Record.


<variable> = zoho.recruit.updateRecord(<module_name>, <record_ID>, <data_map>, <workflow_trigger>, <connection>);


ParameterData typeDescription



variable which will hold the response returned by Zoho Recruit.



module in which the record will be updated.

Applicable modules:

  • Candidates
  • JobOpenings
  • Contacts
  • Clients
  • Interviews
  • Custom Module



ID of the record which will be updated.

Learn how to fetch the ID of a record after creatingsearching it or fetching it.



keys and values to update the record with the new data.

Note: Field names (keys) should be specified as given in the Zoho Recruit API.
  • If this param is supplied with true, all the workflows configured for the specified module will be triggered for the current record.
  • If this param is supplied with false, no workflow will be triggered.



The link name of the Zoho Recruit connection.


  • In view of stopping new authtoken generation, a Zoho OAuth connection with appropriate scopes is mandatory in order for new integration tasks (created after the deadline specified in the post) to work as expected. Existing integration tasks will continue to work with or without the connections parameter until you manually delete the authtoken from accounts.
  • Add relevant scopes mentioned in Zoho Recruit API while creating the connection.
  • Refer to this post for the list of Zoho services that support the connections page.
  • Learn more about connections

Update a record in Candidates module

The following script updates a record in the "Candidates" module in Zoho Recruit.

 candidatesMap = Map();
 response=zoho.recruit.updateRecord("Candidates", 3342000000267001, candidatesMap, false, "recruit_connection");


is a KEY-VALUE variable which will hold keys and values required to update the record.
is a TEXT that represents the label name of field in Zoho Recruit which will get updated.
is a TEXT that represents the updated value of field in Zoho Recruit.
is a TEXT that represents the module in which the record will be updated.
is a BOOLEAN that indicates no workflow will be triggered.
is a TEXT that represents the module in which the record will be updated.

The success response returned is of the following format:

   "Is Locked":"false",
   "Candidate ID":"ZR_23_CAND",
   "Is Unqualified":"false",
   "Updated On":"2015-08-05 18:41:34",
   "Created By":"dinesh.d",
   "Is Attachment Present":"true",
   "Created Time":"2015-08-05 18:41:34",
   "Modified By":"dinesh.d",
   "Candidate Status":"New",
   "Last Activity Time":"2015-08-05 18:41:34",
   "Email Opt Out":"false",
   "Is Hot Candidate":"false",
   "Last Name":"No name",
   "Experience in Years":"0",
   "Candidate Owner":"dinesh.d"

Related Links

Share this post : FacebookTwitter

Still can't find what you're looking for?

Write to us: support@zohodeluge.com