Update Record API

Purpose

This API is used for modifying the field values of the specified record. You can edit the data of a record.

Request URL

https://people.zoho.com/people/api/forms/<inputType>/<formLinkName>/updateRecord?authtoken=<token>&inputData=<inputData>&recordId=<recordId>

Note:

Request Parameters

authtokenSpecify the authentication token
formLinkNameTo get formLinkName,use the Fetch Forms API.
inputTypexml or json
recordIdSpecifies the user record ID of the record being edited
inputDataXML input: <Request><Record><field name="Labelname">value</field><field name="LabelName1">value1</field><field name="Labelname2">value2</field></Record></Request>
JSON input: {LabelName:'value',LabelName1:'value1',LabelName2:'value2'}

Example

XML request:

https://people.zoho.com/people/api/forms/xml/employee/updateRecord?authtoken=7d985878998943g4j09h43dd0b167dda34b&inputData=<Request><Record><field name='Tags'>support</field></Record></Request>&recordId=6000000043063

JSON request:

https://people.zoho.com/people/api/forms/json/employee/updateRecord?authtoken=7d985878998943g4j09h43dd0b167dda34b&inputData={Tags:'support'}&recordId=6000000043063

XML response:

<?xml version=""1.0"" encoding=""UTF-8""?>
<response uri=""/api/forms/employee/xml/updateRecord"">
<status>
0</status>
<message>
Data updated successfully</message><result>
<message>
Successfully Updated</message>
</result>
</response>

JSON response:

{"response":{"message":"Data updated successfully","result":{"message":"Successfully Updated"},"status":0,"uri":"/api/forms/employee/json/updateRecord"}}

Error codes

Please refer Error Codes.

Note:

  • To add or edit data for Lookup field, pass the record ID as value. For example, consider Department lookup in Employee form and let the department be Finance. For this case, the recordID of Finance in the department form is passed as value.