- 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
Add Leave Balance API
To modify an employee's leave balance
Request URL:
https://people.zoho.com/api/leave/addBalance?balanceData=<balanceData>&dateFormat=<dateFormat>
Header:
Authorization:Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf
Scope:
ZOHOPEOPLE.leave.ALL
Request Parameters:
*balanceData (Json string) | { "<EmpErecno>": { "<LeaveType ID>": { "date":"<Date>", "count":"<Balance>" }, ... }, ... } |
dateFormat (String) | Specify the date format (Org date format will be considered if nothing is specified) |
Note:
- The above API will add/subtract the given count.
- Example:
1)Existing balance is 20, if count = 4, new balance will be 24.
2)Existing balance is 20, if count = -4, new balance will be 16.
Threshold Limit: 30 requests | Lock period: 5 minutes
Threshold Limit - Number of API calls allowed within a minute.
Lock Period - Wait time before consecutive API requests.
Request
Copiedhttps://people.zoho.com/api/leave/addBalance?balanceData=<balanceData>&dateFormat=<dateFormat>
Header
CopiedAuthorization:Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf
Response
Copied{
"response": {
"result": {
"addedCount": 20,
"errorCount": 2
},
"message": "Data partially updated",
"uri": "/api/leave/addBalance",
"errors": {
"500161005": {
"500042139": "Ensure date is in 'dd-MMM-yyyy' format for the parameter 'Date'"
},
"500169009": {
"500042112": "Leave type is not applicable for the employee"
}
},
"status": 2
}
}
© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.