- Overview
- What's New in V8?
- Changelog
- Open API Specification 3.0.0 (OAS)
- API Directory
- API Collection
- APIs and References
- OAuth
- API Limits and Credits
- Compliance
- Zoho CRM SDKs
- Metadata APIs
- Customization
- Process Automation
- Security control
- Roles
- Profiles
- Territories
- GETTerritories
- POSTTerritories
- PUTTerritories
- DELETETerritories
- POSTTransfer and Delete Territories
- GETChild Territories of a Territory
- GETTerritories Assigned
- GETAssociated User Count
- GETRetrieve User details Associated with a Territory
- PUTAssociate Users with Territory
- POSTRemove Territories of Records
- POSTAssign Territories to Records
- DELETEDisassociate Users from Territory
- Export Audit Log
- Portals
- Data Sharing
- GETData Sharing Rules
- POSTData Sharing Rules
- PUTData Sharing Rules
- DELETEData Sharing Rules
- GETData Sharing Settings
- PUTData Sharing Settings
- PUTActivate Data Sharing Rule
- DELETEDeactivate Data Sharing Rule
- POSTRerun Data Sharing Rules
- GETData Sharing Rules Summary
- POSTData Sharing Rules Summary Filter
- POSTSearch Data Sharing Rules
- Company Settings
- Zia
- Core APIs
- Records
- Merge Records
- Share Records
- Mail Merge
- Services
- Appointments
- Appointments Rescheduled History
- Fields Attachments
- Meeting Cancel
- Notes
- Mass Actions
- Related Records
- External ID
- Emails
- Subforms
- Linking Modules
- Others
- Bulk APIs
- Composite API
- Query API
- Notification APIs
Common Errors
The 200 series
- OKHTTP 200
The API request is successful.
- CreatedHTTP 201
Message: record added.
Request fulfilled for record insertion. - AcceptedHTTP 202
The request has been accepted. Generally, the server takes time to complete the process.
- No ContentHTTP 204
There is no content available for the request.
- Multi-StatusHTTP 207
The API is partially successful. It shows the record added (for successful insertions) and the error message for unsuccessful insertions.
Request fulfilled for multiple records insertion.
The 300 series
- Not ModifiedHTTP 304
The requested resource has not been modified after the time mentioned in the "If-Modified-Since" header in a GET API.
The 400 series
- BAD REQUESTHTTP 400
The request or the authentication considered is invalid.
- INVALID_DATAHTTP 400
The ID given is invalid.
- AUTHORIZATION ERRORHTTP 401
Invalid API key provided.
- FORBIDDENHTTP 403
No permission to do the operation.
- NOT FOUNDHTTP 404
Invalid request.
- METHOD NOT ALLOWEDHTTP 405
The specified method is not allowed.
- REQUEST ENTITY TOO LARGEHTTP 413
The server did not accept the request while uploading a file, since the limited file size has exceeded.
- UNSUPPORTED MEDIA TYPEHTTP 415
The server did not accept the request while uploading a file, since the media/ file type is not supported.
- TOO MANY REQUESTSHTTP 429
Number of API requests for the 24 hour period is exceeded or the concurrency limit of the user for the app is exceeded.
- INTERNAL SERVER ERRORHTTP 500
Generic error that is encountered due to an unexpected server error.
© 2025, Zoho Corporation Pvt. Ltd. All Rights Reserved.