Insert Record API

To add a record to the form.

Request URL:<inputType>/<formLinkName>/insertRecord?inputData=<inputData>


Authorization:Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf


scope = ZOHOPEOPLE.forms.CREATE 

Possible Operation Types:

ALL - Full access to data​
CREATE - Create form data

Request Parameters:

formLinkNameForm label name. To get formLinkName, refer appendix 
inputTypeXML or json
inputDataXML input: <Request><Record><field name="Labelname">value</field><field name="LabelName1">value1</field><field name="Labelname2">value2</field></Record></Request>
 (refer appendix to know about field label name)
JSON input: {LabelName:'value',LabelName1:'value1',LabelName2:'value2'}

NOTE : To insert a record in tabular section, the values should be sent in JSON Array.


1.To insert a record in tabular section, the values should be sent in JSON Array. 

Request URL:{Employee_ID:'1001',Previous_Company_Name:['Company1', 'Company 2'],Previous_Designation:['Engineer','Manager']}


Authorization:Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf

Here, Previous_Company_Name and Previous_Designation are the field label name of the tabular section. 

Below is the added record.

2. If the form contains any Lookup fields, then Lookup value id has to be sent in the API request instead of lookup value. Refer Appendix Point 2 > Method 3 to get the lookup value using get component API.

3. ​If the form contains muti-select field (for Example, multi-select  dropdown), then the values for the field should be sent with “;”(colon) as the separator. 

Format :

Field_Label_Name : ‘Value1;Value2’

 Threshold Limit:  300 requests | Lock period: 5 minutes

Threshold Limit - Number of API calls allowed within a minute.
Lock Period - Wait time before consecutive API requests.




CopiedAuthorization:Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf


Copied{"response":{"result":{"pkId":"112674000000235025","message":"Successfully Added"},"message":"Data added successfully","uri":"/api/forms/json/Travel_Request/insertRecord","status":0}}