Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zoho Records API

The Records API from Zoho — 3 operation(s) for records.

Zoho Records API is one of 205 APIs that Zoho publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Records. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and code examples.

This API exposes 8 operations across 3 paths, and defines 10 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

8 operations 3 paths 10 schemas 2 DELETE3 GET1 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Authentication
custom
Resource Areas
1

Authentication & Security 1

Zoho Records API declares 1 security scheme for authenticating requests. It defines a custom scheme (iam-oauth2-schema).

Paths & Operations 8

Across 3 paths, the API surfaces 8 operations — 2 DELETE, 3 GET, 1 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Records 8
GET
/{moduleApiName}/actions/count
Get Record Count in a Module
getCount 11 params → 200400401500
GET
/{module}
Get Records for a specific module
getRecords 12 params → 200204400403404500
POST
/{module}
Create a Record in a specific module
createRecords 1 param body → 201400401403404500
PUT
/{module}
To update existing entities or records in a specified module
updateRecords 1 param body → 200400401403404412500
DELETE
/{module}
Delete multiple records from a module
deleteRecords 2 params → 200207400401403404500
GET
/{module}/{recordID}
Get Record for a specific module with RecordId
getRecord 2 params → 200204400403404500
PUT
/{module}/{recordID}
To update existing entities or records in a specified module with the recordID
updateRecord 2 params body → 200400401403404412500
DELETE
/{module}/{recordID}
Delete a single record by ID
deleteRecord 2 params → 200400401403404500

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are RecordsInputSchema (4 properties), ErrorResponse (4 properties), RecordGETSucessResponse (2 properties), RecordSuccessResponse (1 property). Each schema is shown below with its type and property counts.

ErrorResponse
object
A standard error response from the Zoho CRM API.
4 properties
RecordUnathorizedResponse
object
Response schema returned when a request is unauthorized due to OAuth scope mismatches.
1 property
RecordInternalErrorResponse
object
Schema for internal server error responses related to record operations.
1 property
RecordInvalidURLResponse
object
Response schema returned when the requested API endpoint URL pattern is invalid or unsupported.
1 property
RecordGETErrorResponse
object
Error response schema returned when GET record or GET records operations fail due to validation, pagination, or processing errors.
1 property
RecordsErrorResponse
object
Standard error response schema returned when one or more record operations fail.
1 property
RecordGETSucessResponse
object
Successful response schema returned for GET record or GET records API operations.
2 properties
RecordSuccessResponse
object
Standard success response schema for single or bulk record operations.
1 property 1 required
RecordsInputSchema
object
Input schema for create, update, or upsert record requests.
4 properties 1 required
RecordPermissionResponse
object
Response schema returned when a user lacks the necessary permissions to perform a record operation.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-records-api-openapi.yml Raw ↑

Other APIs Zoho publishes across the network.

Zoho Inventory
Zoho Books
Zoho Invoice
Zoho Billing
Zoho Expense
Zoho People
Zoho Recruit
Zoho Projects
Zoho Mail
Zoho Sign
Zoho Campaigns
Zoho SalesIQ