Zoho CRM

Zoho CRM Notes API

The Notes API from Zoho CRM — 4 operation(s) for notes.

Documentation GitHub OpenAPI

Operations 14

GET /Notes Get Notes #

POST /Notes Create Notes #

PUT /Notes Update Notes #

DELETE /Notes Delete Notes #

GET /Notes/{id} Get a Specific Note #

PUT /Notes/{id} Update a Specific Note #

DELETE /Notes/{id} Delete a Specific Note #

GET /{parentRecordModule}/{parentRecordId}/Notes List Notes for a Record #

POST /{parentRecordModule}/{parentRecordId}/Notes Create Notes for a Record #

PUT /{parentRecordModule}/{parentRecordId}/Notes Update Multiple Notes for a Record #

DELETE /{parentRecordModule}/{parentRecordId}/Notes Delete Note(s) for a Record #

GET /{parentRecordModule}/{parentRecordId}/Notes/{noteId} Get a Specific Note #

PUT /{parentRecordModule}/{parentRecordId}/Notes/{noteId} Update a Note #

DELETE /{parentRecordModule}/{parentRecordId}/Notes/{noteId} Delete a Specific Note #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/zoho-crm-notes-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Zoho Crm Notes API
  version: '1.0'
  description: 'Operations tagged Notes across 2 of this provider''s published API definitions: zoho-crm-notes-openapi.json, zoho-crm-related-notes-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://zohoapis.{dc}/crm/{version}
  description: API Server URL
  variables:
    dc:
      enum:
      - com
      - eu
      - in
      - cn
      - au
      default: com
      description: API Server URL TLD
    version:
      default: v8
      description: API Version
tags:
- name: Notes
paths:
  /Notes:
    get:
      operationId: getNotesModule
      summary: Get Notes
      description: Retrieves a list of notes.
      security:
      - iam-oauth2-schema:
        - ZohoCRM.modules.notes.READ
      parameters:
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/PerPage'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/PageToken'
      - $ref: '#/components/parameters/SortOrder'
      - $ref: '#/components/parameters/SortBy'
      responses:
        '200':
          description: Successful response with note records
          content:
            application/json:
              schema:
                type: object
                description: Response containing note data and pagination information
                additionalProperties: false
                properties:
                  data:
                    type: array
                    description: Array of note records
                    maxItems: 200
                    items:
                      type: object
                      description: A note record with static fields and dynamic additional properties
                      additionalProperties: true
                      properties:
                        id:
                          type: string
                          description: Unique identifier of the note
                          format: int64
                        Note_Title:
                          type:
                          - string
                          - 'null'
                          description: The title of the note
                          maxLength: 120
                        Note_Content:
                          type:
                          - string
                          - 'null'
                          description: The content/body of the note
                          maxLength: 65535
                        $attachments:
                          type:
                          - array
                          - 'null'
                          description: Attachments associated with the note
                          maxItems: 5
                          items:
                            type: object
                            description: Attachment file details
                            additionalProperties: true
                            properties:
                              $file_id:
                                type: string
                                description: Unique file identifier for the attachment
                                maxLength: 255
                              File_Name:
                                type: string
                                description: Name of the attached file
                                maxLength: 255
                              Size:
                                type: string
                                description: File size in bytes
                                format: int64
                              id:
                                type: string
                                description: Unique identifier of the attachment record
                                format: int64
                        Parent_Id:
                          type: object
                          description: Parent record information
                          additionalProperties: false
                          properties:
                            module:
                              type: object
                              description: Module information of the parent record
                              additionalProperties: false
                              properties:
                                api_name:
                                  type: string
                                  description: API name of the parent module
                                  maxLength: 50
                                id:
                                  type: string
                                  description: Module ID
                                  format: int64
                              required:
                              - api_name
                              - id
                            name:
                              type: string
                              description: Name of the parent record
                              maxLength: 255
                            id:
                              type: string
                              description: Unique identifier of the parent record
                              format: int64
                          required:
                          - module
                          - id
                          - name
                      required:
                      - id
                  info:
                    type: object
                    description: Pagination metadata
                    additionalProperties: false
                    properties:
                      page:
                        type: integer
                        format: int32
                        description: Current page number
                      per_page:
                        type: integer
                        format: int32
                        description: Number of records per page
                      count:
                        type: integer
                        format: int32
                        description: Number of records in current page
                      more_records:
                        type: boolean
                        description: Indicates if more records are available
                      next_page_token:
                        type:
                        - string
                        - 'null'
                        description: Token for fetching the next page
                        maxLength: 2000
                      previous_page_token:
                        type:
                        - string
                        - 'null'
                        description: Token for fetching the previous page
                        maxLength: 2000
                      page_token_expiry:
                        type:
                        - string
                        - 'null'
                        format: date-time
                        description: Expiry time of page tokens
                      sort_by:
                        type: string
                        description: Field by which the results are sorted
                        maxLength: 50
                      sort_order:
                        type: string
                        description: Sort order of the results
                        enum:
                        - asc
                        - desc
                    required:
                    - page
                    - per_page
                    - count
                    - more_records
                required:
                - data
                - info
        '204':
          $ref: '#/components/responses/NoContent'
        '400':
          description: Bad Request - Invalid parameters or malformed request
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/RequiredParamMissingError'
                - $ref: '#/components/schemas/DiscretePaginationLimitExceededError'
                - $ref: '#/components/schemas/ExpiredValueError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      tags:
      - Notes
    post:
      operationId: createNotesModule
      summary: Create Notes
      description: Creates one or more note records.
      security:
      - iam-oauth2-schema:
        - ZohoCRM.modules.notes.CREATE
      requestBody:
        description: Request body containing note data to create
        content:
          application/json:
            schema:
              type: object
              description: Request payload for creating notes
              additionalProperties: false
              properties:
                data:
                  type: array
                  description: Array of note objects to create
                  maxItems: 100
                  items:
                    type: object
                    description: Note object with title, content, and parent information
                    additionalProperties: true
                    properties:
                      Note_Content:
                        type:
                        - string
                        - 'null'
                        description: The content/body of the note
                        maxLength: 65535
                      Note_Title:
                        type:
                        - string
                        - 'null'
                        description: The title of the note
                        maxLength: 120
                      Parent_Id:
                        type: object
                        description: Parent record information
                        additionalProperties: false
                        properties:
                          module:
                            type: object
                            description: Module information of the parent record
                            additionalProperties: false
                            properties:
                              api_name:
                                type: string
                                description: API name of the parent module
                                maxLength: 50
                              id:
                                type: string
                                description: Module ID
                                format: int64
                          id:
                            type: string
                            description: Unique identifier of the parent record
                            format: int64
                        required:
                        - module
                        - id
              required:
              - data
        required: true
      responses:
        '201':
          description: Created - Note(s) successfully created
          content:
            application/json:
              schema:
                type: object
                description: Success response for note creation
                additionalProperties: false
                properties:
                  data:
                    type: array
                    description: Array of creation results
                    maxItems: 100
                    items:
                      type: object
                      description: Individual note creation result
                      additionalProperties: false
                      properties:
                        code:
                          type: string
                          description: Result code
                          enum:
                          - SUCCESS
                        message:
                          type: string
                          description: Result message
                          maxLength: 500
                        status:
                          type: string
                          description: Status of the operation
                          enum:
                          - success
                        details:
                          type: object
                          description: Created note details
                          additionalProperties: false
                          properties:
                            id:
                              type: string
                              description: Unique identifier of the created note
                              format: int64
                            Modified_Time:
                              type: string
                              description: Timestamp when the note was last modified
                              format: date-time
                            Created_Time:
                              type: string
                              description: Timestamp when the note was created
                              format: date-time
                            Created_By:
                              type: object
                              description: User who created the note
                              additionalProperties: false
                              properties:
                                name:
                                  type: string
                                  description: Name of the user
                                  maxLength: 120
                                id:
                                  type: string
                                  description: Unique identifier of the user
                                  format: int64
                              required:
                              - name
                              - id
                            Modified_By:
                              type: object
                              description: User who last modified the note
                              additionalProperties: false
                              properties:
                                name:
                                  type: string
                                  description: Name of the user
                                  maxLength: 255
                                id:
                                  type: string
                                  description: Unique identifier of the user
                                  format: int64
                              required:
                              - name
                              - id
                          required:
                          - id
                          - Modified_Time
                          - Created_Time
                          - Created_By
                          - Modified_By
                      required:
                      - code
                      - message
                      - status
                      - details
                required:
                - data
        '207':
          description: Multi-Status - Partial success with some records created and some failed
          content:
            application/json:
              schema:
                type: object
                description: Multi-status response for note creation with mixed results
                additionalProperties: false
                properties:
                  data:
                    type: array
                    description: Array of creation results with mixed success and error statuses
                    maxItems: 100
                    items:
                      oneOf:
                      - type: object
                        description: Successful note creation result
                        additionalProperties: false
                        properties:
                          code:
                            type: string
                            description: Result code
                            enum:
                            - SUCCESS
                          message:
                            type: string
                            description: Result message
                            maxLength: 500
                          status:
                            type: string
                            description: Status of the operation
                            enum:
                            - success
                          details:
                            type: object
                            description: Created note details
                            additionalProperties: false
                            properties:
                              id:
                                type: string
                                description: Unique identifier of the created note
                                format: int64
                              Modified_Time:
                                type: string
                                description: Timestamp when the note was last modified
                                format: date-time
                              Created_Time:
                                type: string
                                description: Timestamp when the note was created
                                format: date-time
                              Created_By:
                                type: object
                                description: User who created the note
                                additionalProperties: false
                                properties:
                                  name:
                                    type: string
                                    description: Name of the user
                                    maxLength: 255
                                  id:
                                    type: string
                                    description: Unique identifier of the user
                                    format: int64
                                required:
                                - name
                                - id
                              Modified_By:
                                type: object
                                description: User who last modified the note
                                additionalProperties: false
                                properties:
                                  name:
                                    type: string
                                    description: Name of the user
                                    maxLength: 255
                                  id:
                                    type: string
                                    description: Unique identifier of the user
                                    format: int64
                                required:
                                - name
                                - id
                            required:
                            - id
                            - Modified_Time
                            - Created_Time
                            - Created_By
                            - Modified_By
                        required:
                        - code
                        - message
                        - status
                        - details
                      - type: object
                        description: Failed note creation result
                        additionalProperties: false
                        properties:
                          code:
                            type: string
                            description: Error code
                            enum:
                            - EXPECTED_FIELD_MISSING
                            - INVALID_DATA
                          message:
                            type: string
                            description: Error message
                            maxLength: 500
                          status:
                            type: string
                            description: Status of the operation
                            enum:
                            - error
                          details:
                            type: object
                            description: Error details
                            additionalProperties: true
                        required:
                        - code
                        - message
                        - status
                        - details
                required:
                - data
        '400':
          description: Bad Request - Invalid parameters or malformed request
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/ExpectedFieldMissingError'
                - $ref: '#/components/schemas/InvalidDataError'
                - $ref: '#/components/schemas/InvalidDataLimitExceededError'
                - $ref: '#/components/schemas/NotAllowedError'
                - $ref: '#/components/schemas/FileSizeExceedsError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          description: Forbidden - User lacks required permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NoPermissionError'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      tags:
      - Notes
    put:
      operationId: updateNotesModule
      summary: Update Notes
      description: Updates one or more existing note records. Either note content or note title must be provided (at least one is mandatory) for each note.
      security:
      - iam-oauth2-schema:
        - ZohoCRM.modules.notes.UPDATE
      requestBody:
        description: Request body containing note data to update
        content:
          application/json:
            schema:
              type: object
              description: Request payload for updating notes
              additionalProperties: false
              properties:
                data:
                  type: array
                  description: Array of note objects to update
                  maxItems: 100
                  items:
                    type: object
                    description: Note object with id, title and/or content to update
                    additionalProperties: true
                    properties:
                      id:
                        type: string
                        description: Unique identifier of the note to update
                        format: int64
                      Note_Content:
                        type:
                        - string
                        - 'null'
                        description: The content/body of the note
                        maxLength: 65535
                      Note_Title:
                        type:
                        - string
                        - 'null'
                        description: The title of the note
                        maxLength: 120
                    required:
                    - id
              required:
              - data
        required: true
      responses:
        '200':
          description: Success - Note(s) successfully updated
          content:
            application/json:
              schema:
                type: object
                description: Success response for note update
                additionalProperties: false
                properties:
                  data:
                    type: array
                    description: Array of update results
                    maxItems: 100
                    items:
                      type: object
                      description: Individual note update result
                      additionalProperties: false
                      properties:
                        code:
                          type: string
                          description: Result code
                          enum:
                          - SUCCESS
                        message:
                          type: string
                          description: Result message
                          maxLength: 500
                        status:
                          type: string
                          description: Status of the operation
                          enum:
                          - success
                        details:
                          type: object
                          description: Updated note details
                          additionalProperties: false
                          properties:
                            id:
                              type: string
                              description: Unique identifier of the updated note
                              format: int64
                            Modified_Time:
                              type: string
                              description: Timestamp when the note was last modified
                              format: date-time
                            Created_Time:
                              type: string
                              description: Timestamp when the note was created
                              format: date-time
                            Created_By:
                              type: object
                              description: User who created the note
                              additionalProperties: false
                              properties:
                                name:
                                  type: string
                                  description: Name of the user
                                  maxLength: 255
                                id:
                                  type: string
                                  description: Unique identifier of the user
                                  format: int64
                              required:
                              - name
                              - id
                            Modified_By:
                              type: object
                              description: User who last modified the note
                              additionalProperties: false
                              properties:
                                name:
                                  type: string
                                  description: Name of the user
                                  maxLength: 255
                                id:
                                  type: string
                                  description: Unique identifier of the user
                                  format: int64
                              required:
                              - name
                              - id
                          required:
                          - id
                          - Modified_Time
                          - Created_Time
                          - Created_By
                          - Modified_By
                      required:
                      - code
                      - message
                      - status
                      - details
                required:
                - data
        '207':
          description: Multi-Status - Partial success with some records updated and some failed
          content:
            application/json:
              schema:
                type: object
                description: Multi-status response for note update with mixed results
                additionalProperties: false
                properties:
                  data:
                    type: array
                    description: Array of update results with mixed success and error statuses
                    maxItems: 100
                    items:
                      oneOf:
                      - type: object
                        description: Successful note update result
                        additionalProperties: false
                        properties:
                          code:
                            type: string
                            description: Result code
                            enum:
                            - SUCCESS
                          message:
                            type: string
                            description: Result message
                            maxLength: 500
                          status:
                            type: string
                            description: Status of the operation
                            enum:
                            - success
                          details:
                            type: object
                            description: Updated note details
                            additionalProperties: false
                            properties:
                              id:
                                type: string
                                description: Unique identifier of the updated note
                                format: int64
                              Modified_Time:
                                type: string
                                description: Timestamp when the note was last modified
                                format: date-time
                              Created_Time:
                                type: string
                                description: Timestamp when the note was created
                                format: date-time
                              Created_By:
                                type: object
                                description: User who created the note
                                additionalProperties: false
                                properties:
                                  name:
                                    type: string
                                    description: Name of the user
                                    maxLength: 255
                                  id:
                                    type: string
                                    description: Unique identifier of the user
                                    format: int64
                                required:
                                - name
                                - id
                              Modified_By:
                                type: object
                                description: User who last modified the note
                                additionalProperties: false
                                properties:
                                  name:
                                    type: string
                                    description: Name of the user
                                    maxLength: 255
                                  id:
                                    type: string
                                    description: Unique identifier of the user
                                    format: int64
                                required:
                                - name
                                - id
                            required:
                            - id
                            - Modified_Time
                            - Created_Time
                            - Created_By
                            - Modified_By
                        required:
                        - code
                        - message
                        - status
                        - details
                      - type: object
                        description: Failed note update result
                        additionalProperties: false
                        properties:
                          code:
                            type: string
                            description: Error code
                            enum:
                            - EXPECTED_FIELD_MISSING
                            - MANDATORY_NOT_FOUND
                            - INVALID_DATA
                          message:
                            type: string
                            description: Error message
                            maxLength: 500
                          status:
                            type: string
                            description: Status of the operation
                            enum:
                            - error
                          details:
                            type: object
                            description: Error details
                            additionalPrope

# --- truncated at 32 KB (161 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoho-crm/refs/heads/main/openapi/zoho-crm-notes-api-openapi.yml