Update Record API

Purpose:

This API is used for modifying the field values of the specified record.

Request URL:

https://people.zoho.com/api/forms/json/employee/updateRecord

Header:

Authorization:Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf

Scope

scope = ZOHOPEOPLE.forms.UPDATE

Possible Operation Types:

UPDATE - Update form data

Request Parameters:

PARAMETERSVALUES ALLOWEDDEFAULT VALUEPARAMETER DESCRIPTIONMANDATORY
formLinkName--Form Lable Name. To get formLinkName, refer appendixYes
recordId---Yes
inputData--Specifies the record Id of the record being fetched. The record Id can be identified using the 
bulk records API.		Yes
isDrafttrue | false--No
tabularData--Data for tabular section rows that can be added, updated, or deleted.No
inputData

JSON input:

{​LabelName:'value',Labelname1:'value1','Labelname2:'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.

Sample Request

Copiedhttps://people.zoho.com/api/forms/json/employee/updateRecord

Sample Response

Copied{
    "response": {
        "result": {
            "pkId": "100002000000038085",
            "message": "Successfully Updated"
        },
        "message": "Data updated successfully",
        "uri": "/api/forms/json/employee/updateRecord",
        "status": 0
    }
}
JavaJavaScriptCurlDelugePython
CopiedOkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "inputData={\"Single_Line_1\":\"John Doe\",\"Multi_Line_1\":\"This is a multiline field\"}&recordId=100002000000038085");
Request request = new Request.Builder()
  .url("https://people.zoho.com/api/forms/json/employee/updateRecord")
  .method("POST", body)
  .addHeader("Content-Type", "application/x-www-form-urlencoded")
  .addHeader("Authorization", "••••••")
  .addHeader("Cookie", "CSRF_TOKEN=690c414e-0417-400a-a84b-eac31d7bffc4; _zcsr_tmp=690c414e-0417-400a-a84b-eac31d7bffc4; _zpsid=83975D3AFB3CB765B17B48E48C8FE2A0")
  .build();
Response response = client.newCall(request).execute();
Copiedconst myHeaders = new Headers();
myHeaders.append("Content-Type", "application/x-www-form-urlencoded");
myHeaders.append("Authorization", "••••••");
myHeaders.append("Cookie", "CSRF_TOKEN=690c414e-0417-400a-a84b-eac31d7bffc4; _zcsr_tmp=690c414e-0417-400a-a84b-eac31d7bffc4; _zpsid=83975D3AFB3CB765B17B48E48C8FE2A0");

const urlencoded = new URLSearchParams();
urlencoded.append("inputData", "{\"Single_Line_1\":\"John Doe\",\"Multi_Line_1\":\"This is a multiline field\"}");
urlencoded.append("recordId", "100002000000038085");

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: urlencoded,
  redirect: "follow"
};

fetch("https://people.zoho.com/api/forms/json/employee/updateRecord", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));
Copiedcurl --location 'https://people.zoho.com/api/forms/json/employee/updateRecord' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: ••••••' \
--header 'Cookie: CSRF_TOKEN=690c414e-0417-400a-a84b-eac31d7bffc4; _zcsr_tmp=690c414e-0417-400a-a84b-eac31d7bffc4; _zpsid=83975D3AFB3CB765B17B48E48C8FE2A0' \
--data-urlencode 'inputData={"Single_Line_1":"John Doe","Multi_Line_1":"This is a multiline field"}' \
--data-urlencode 'recordId=100002000000038085'
CopiedinputMap = Map();
inputMap.put("recordId","100002000000038085");
inputMap.put("inputData","{"Single_Line_1":"John Doe","Multi_Line_1":"This is a multiline field"}");
AuthMap = Collection();
AuthMap.insert("Authorization":"••••••");

response = invokeUrl
[
 	url: "https://people.zoho.com/api/forms/json/employee/updateRecord"
 	type: POST
 	parameters: inputMap
 	headers: AuthMap.toMap()
];
info response;
Copiedimport requests

url = "https://people.zoho.com/api/forms/json/employee/updateRecord"

payload = 'inputData=%7B%22Single_Line_1%22%3A%22John%20Doe%22%2C%22Multi_Line_1%22%3A%22This%20is%20a%20multiline%20field%22%7D&recordId=100002000000038085'
headers = {
  'Content-Type': 'application/x-www-form-urlencoded',
  'Authorization': '••••••',
  'Cookie': 'CSRF_TOKEN=690c414e-0417-400a-a84b-eac31d7bffc4; _zcsr_tmp=690c414e-0417-400a-a84b-eac31d7bffc4; _zpsid=83975D3AFB3CB765B17B48E48C8FE2A0'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)