- Overview
- Authentication
- Organization
- API Limits
- Forms API
- Cases API
- Timesheet API
- Onboarding API
- Announcements API
- Leave API
- Attendance API
- Compensation API
- GETFetch Components API
- GETFetch Components by ID API
- GETFetch Salary Components API
- GETFetch Packages API
- GETFetch Package by ID API
- GETFetch Package Components API
- GETFetch Currencies API
- GETFetch Currency by ID
- GETFetch Revisions API
- GETFetch Revisions by ERECNO API
- GETFetch Revision Letters by ERECNO API
- GETPreview Revision Letter by Revision ID API
- GETDownload Revision Letter by Revision ID API
- GETFetch My Compensation API
- GETFetch Reasons API
- GETFetch Settings API
- PUTCancel Revision API
- GETFetch Salary API
- GETFetch Single Employee Salary API
- POSTAdd Salary API
- PUTUpdate Salary API
- Compensation API Error Codes
- Record Count API
- LMS API
- Courses API
- Pre Learning Activities API
- Post Learning Activities API
- Course Action API
- Course Learner API
- Batch API
- Batch Scheduler API
- Batch Action API
- Module API
- File API
- Content API
- Link API
- Session API
- Offline Test API
- Online Test API
- Assignment API
- Settings API
- Trainer API
- Rooms API
- Categories API
- LMS Api Error Codes
- Files API
- View API
- Standalone Function
- Status Codes
- Error Codes API
- HTTP Request Methods
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:
PARAMETERS | VALUES ALLOWED | DEFAULT VALUE | PARAMETER DESCRIPTION | MANDATORY |
---|---|---|---|---|
formLinkName | - | - | Form Lable Name. To get formLinkName, refer appendix | Yes |
recordId | - | - | - | Yes |
inputData | - | - | Specifies the record Id of the record being fetched. The record Id can be identified using the bulk records API. | Yes |
isDraft | true | 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
}
}
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)
Show full
Show less
© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.