Update Records in Zoho CRM

Update Records in Zoho CRM


Zoho Creator and Zoho CRM have been integrated for efficient usability purposes. We have developed tasks in Zoho Creator to perform automatic actions in Zoho CRM, which would otherwise require manual execution. For example, you can update records in Zoho CRM by simply submitting a Form with relevant details in Zoho Creator.  This can be achieved using zoho.crm.updateRecord() task in Zoho Creator.

Use Case Scenario

Let's say we have a Zoho Creator Form which stores Leads information. To update existing Lead details in Zoho CRM you can execute the zoho.crm.updateRecord() task. The specified record is updated when the Form is submitted with updated information. Further details on how to execute this task are explained below.


<response> =zoho.crm.updateRecord(<module_name>, <record_ID>, <data_map>, {<optional_data_map>}, <connections>);


Params Description


is the response returned as MAP by Zoho CRM.


is the API name of the CRM module, of STRING datatype, where the records will be updated. Following is the list of supported modules.














is the record id, of NUMBER datatype, that needs to be updated.


Input map with key as each field's API name and its updated value. For ex: {"Last_name":"Zoho CRM"}



Represents all the other data in a map other than input MAP.


Displays the connectors associated with the function. Datatype is STRING.

Example 1: Update a Lead record by specifying it's id

Let's assume we have a Zoho Creator Form with the following fields:

  • Lead(Zoho CRM Leads field type)
  • Company Name (Zoho CRM Leads field type)
  • Name (Single Line field type)
  • Telephone (Number field type)
  • Email Address (Email field type)

Add the following script in On Add > On Success to update details of the specified Lead id.

leadinfo = {"Company":input.Company_Name, "Last_Name":input.Name, "Phone":input.Telephone, 

response = zoho.crm.updateRecord("Leads",input.Lead_ID,leadinfo);


contains key values pairs, where the keys are API names of Zoho CRM fields and values are updated field inputs.
is the response returned as map by Zoho CRM. The fetched records will be contained in the response. Check sample response here.
is the label name of Zoho CRM Leads Module, of string datatype, where the records will be updated.
refers to the Form field(Lead) input.

Example 2: Update a Quote with Product details by specifying the Quote ID

Let's assume we have a Zoho Creator Form used to store Quotes and its Products details. The Form consists of the following fields:

  • Subject (Single Line field type)
  • Account (Zoho CRM Accounts field type)
  • Product Details (Subform field type) containing Product (Zoho CRM Products field type) and Quantity (Number field type)

Add the following script in On Add > On Success section of your Form to update an existing Quotes record:

quoteDetails = map(); 
quoteDetails.put("Subject", input.Subject); 
quoteDetails.put("Account_Name", {"id":input.CRM_ACCOUNT_ID);productsList = List:Map(); 
for each product in input.Product_Details 
Product_Details = map(); 
Product_Details.put("product", {"id":product.CRM_PRODUCT_ID);Product_Details.put("quantity", product.Quantity); 
quoteDetails.put("Product_Details", productsList); 

response = zoho.crm.updateRecord("Quotes", QuotesID, quoteDetails);


is the response returned as map by Zoho CRM. The fetched records will be contained in the response. Check sample response here.
are API names of Zoho CRM fields. They are of string data-type.
are Zoho Creator field inputs.
is Subform field input.
stands for each subform entry or record.
are unique Subform field inputs for each Subform entry or record.
is a list variable containing map values of subform field inputs.
is the CRM module, of string datatype, where the record will be updated.
is response returned as map by Zoho CRM. Check sample response here.

Response Format

The response returned is of the following format:



CRM Tasks can be executed only in accounts which are under Flexible and Unlimited Plans. Accounts under Free Plan, kindly upgrade to use CRM tasks. For more details scroll down to Integration and Web Data on the pricing page.

Script Builder

You can also make use of Script builder to define the zoho.crm.updateRecord() task. Navigate to your application’s Workflow and drag and drop the Call Function under Deluge Tasks > Miscellaneous. Select Integration tasks and fill out necessary information.

Related Links

  • To fetch the string value to which the specified key is mapped, use get()
  • To get values from fetched records, use getJSON()
  • To convert the json string to list format, use toJSONList().

Share this post : FacebookTwitter

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

Write to us: support@zohocreator.com