Zoho CRM

Zoho CRM Contacts API

The Contacts API from Zoho CRM — 4 operation(s) for contacts.

Documentation GitHub OpenAPI

Business capability

Customer Data Management BC-420.10

Operations 11

GET /contacts/roles Get Contact Roles #

POST /contacts/roles Create Contact Roles #

PUT /contacts/roles Update Contact Roles #

DELETE /contacts/roles Delete Contact Roles #

GET /contacts/roles/{role} Get Role #

PUT /contacts/roles/{role} Update Role #

DELETE /contacts/roles/{role} Delete Role #

POST /Contacts/{contactId}/Emails/actions/link_record Link Emails to Deals #

DELETE /Contacts/{contactId}/Emails/actions/link_record Unlink Emails from Records #

POST /Contacts/{contactId}/Emails/{messageId}/actions/link_record Link Email to Record #

DELETE /Contacts/{contactId}/Emails/{messageId}/actions/link_record Unlink Email from Record #

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-contacts-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 Contacts API
  version: '1.0'
  description: 'Operations tagged Contacts across 2 of this provider''s published API definitions: zoho-crm-contact-roles-openapi.json, zoho-crm-deal-link-emails-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: Contacts
paths:
  /contacts/roles:
    get:
      summary: Get Contact Roles
      description: Retrieves a list of contact roles
      operationId: getContactRoles
      responses:
        '200':
          description: Contact roles retrieved successfully
          content:
            application/json:
              schema:
                type: object
                description: Response containing contact roles
                additionalProperties: false
                properties:
                  contact_roles:
                    type: array
                    description: Array of contact roles
                    maxItems: 100
                    items:
                      type: object
                      description: Contact role details
                      additionalProperties: false
                      properties:
                        name:
                          type: string
                          description: Name of the contact role
                          pattern: '[A-Za-z0-9 ]'
                          maxLength: 50
                        id:
                          type: string
                          description: Unique identifier for the contact role
                          maxLength: 19
                        sequence_number:
                          type: number
                          description: Sequence number for ordering
                      required:
                      - name
                      - id
                      - sequence_number
                required:
                - contact_roles
        '204':
          description: No contact roles found
      security:
      - iam-oauth2-schema:
        - ZohoCRM.modules.contacts.READ
      tags:
      - Contacts
    post:
      summary: Create Contact Roles
      description: Creates one or more contact roles.
      operationId: createRoles
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: Request body for creating contact roles
              additionalProperties: false
              properties:
                contact_roles:
                  type: array
                  description: Array of contact roles to create
                  maxItems: 100
                  items:
                    type: object
                    description: Contact role details
                    additionalProperties: false
                    properties:
                      name:
                        type: string
                        description: Name of the contact role
                        pattern: '[A-Za-z0-9 ]{1,50}'
                        maxLength: 50
                      sequence_number:
                        type: number
                        description: Sequence number for ordering
                    required:
                    - name
                    - sequence_number
              required:
              - contact_roles
        required: true
      responses:
        '200':
          description: Contact Role created successfully
          content:
            application/json:
              schema:
                type: object
                description: Response object for successful contact role creation.
                additionalProperties: false
                properties:
                  contact_roles:
                    type: array
                    description: Array of contact role creation results
                    maxItems: 100
                    items:
                      type: object
                      description: Contact role creation result details.
                      additionalProperties: false
                      properties:
                        code:
                          type: string
                          description: Status code for the operation.
                          enum:
                          - SUCCESS
                        details:
                          type: object
                          description: Details of the created contact role.
                          additionalProperties: false
                          properties:
                            id:
                              type: string
                              description: Unique identifier for the created contact role.
                              maxLength: 19
                          required:
                          - id
                        message:
                          type: string
                          description: Operation message.
                          maxLength: 255
                        status:
                          type: string
                          description: Operation status.
                          enum:
                          - success
                      required:
                      - code
                      - details
                      - message
                      - status
                required:
                - contact_roles
        '400':
          description: Error in creating contact roles
          content:
            application/json:
              schema:
                oneOf:
                - type: object
                  description: Error response with array of contact role errors.
                  additionalProperties: false
                  properties:
                    contact_roles:
                      type: array
                      description: Array of error responses for contact roles.
                      maxItems: 100
                      items:
                        oneOf:
                        - type: object
                          description: Invalid data error.
                          additionalProperties: false
                          properties:
                            code:
                              type: string
                              description: Error code.
                              enum:
                              - INVALID_DATA
                            message:
                              type: string
                              description: Error message.
                              maxLength: 255
                            details:
                              type: object
                              description: Error details.
                              additionalProperties: false
                              properties:
                                api_name:
                                  type: string
                                  description: API name of the field.
                                  maxLength: 100
                                json_path:
                                  type: string
                                  description: JSON path to the field.
                                  maxLength: 255
                                expected_data_type:
                                  type: string
                                  description: Expected data type for the field.
                                  maxLength: 100
                              required:
                              - api_name
                              - json_path
                              - expected_data_type
                            status:
                              type: string
                              description: Error status.
                              enum:
                              - error
                          required:
                          - code
                          - message
                          - details
                          - status
                        - type: object
                          description: Mandatory field not found error.
                          additionalProperties: false
                          properties:
                            code:
                              type: string
                              description: Error code.
                              enum:
                              - MANDATORY_NOT_FOUND
                            message:
                              type: string
                              description: Error message.
                              maxLength: 255
                            details:
                              type: object
                              description: Error details.
                              additionalProperties: false
                              properties:
                                api_name:
                                  type: string
                                  description: API name of the field.
                                  maxLength: 100
                                json_path:
                                  type: string
                                  description: JSON path to the field.
                                  maxLength: 255
                              required:
                              - api_name
                              - json_path
                            status:
                              type: string
                              description: Error status.
                              enum:
                              - error
                          required:
                          - code
                          - message
                          - details
                          - status
                        - type: object
                          description: Duplicate data error.
                          additionalProperties: false
                          properties:
                            code:
                              type: string
                              description: Error code.
                              enum:
                              - DUPLICATE_DATA
                            message:
                              type: string
                              description: Error message.
                              maxLength: 255
                            details:
                              type: object
                              description: Error details.
                              additionalProperties: false
                              properties:
                                api_name:
                                  type: string
                                  description: API name of the field.
                                  maxLength: 100
                                json_path:
                                  type: string
                                  description: JSON path to the field.
                                  maxLength: 255
                              required:
                              - api_name
                              - json_path
                            status:
                              type: string
                              description: Error status.
                              enum:
                              - error
                          required:
                          - code
                          - message
                          - details
                          - status
                  required:
                  - contact_roles
      security:
      - iam-oauth2-schema:
        - ZohoCRM.modules.contacts.WRITE
      tags:
      - Contacts
    put:
      summary: Update Contact Roles
      description: Updates one or more contact roles.
      operationId: updateRoles
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: Response containing a list of contact roles.
              additionalProperties: false
              properties:
                contact_roles:
                  type: array
                  description: Array of contact role objects.
                  maxItems: 100
                  items:
                    type: object
                    description: Contact role details.
                    additionalProperties: false
                    properties:
                      name:
                        type: string
                        description: Name of the contact role.
                        pattern: '[A-Za-z0-9 ]{1,50}'
                        maxLength: 50
                      id:
                        type: string
                        description: Unique identifier for the contact role.
                        maxLength: 19
                      sequence_number:
                        type: number
                        description: Sequence number for ordering, can be object or null.
                    required:
                    - name
                    - id
              required:
              - contact_roles
        required: true
      responses:
        '200':
          description: Contact role updated successfully
          content:
            application/json:
              schema:
                type: object
                description: Response object for successful contact role update.
                additionalProperties: false
                properties:
                  contact_roles:
                    type: array
                    description: Array of contact role update results
                    maxItems: 100
                    items:
                      type: object
                      description: Contact role update result details.
                      additionalProperties: false
                      properties:
                        code:
                          type: string
                          description: Status code for the operation.
                          enum:
                          - SUCCESS
                        details:
                          type: object
                          description: Details of the updated contact role.
                          additionalProperties: false
                          properties:
                            id:
                              type: string
                              description: Unique identifier for the updated contact role.
                              maxLength: 19
                          required:
                          - id
                        message:
                          type: string
                          description: Operation message.
                          maxLength: 255
                        status:
                          type: string
                          description: Operation status.
                          enum:
                          - success
                      required:
                      - code
                      - details
                      - message
                      - status
                required:
                - contact_roles
        '400':
          description: Error in updating contact roles
          content:
            application/json:
              schema:
                oneOf:
                - type: object
                  description: Error response wrapper for contact role update failures
                  additionalProperties: false
                  properties:
                    contact_roles:
                      type: array
                      description: Array of error responses for contact roles
                      maxItems: 100
                      items:
                        oneOf:
                        - type: object
                          description: Mandatory field not found error.
                          additionalProperties: false
                          properties:
                            code:
                              type: string
                              description: Error code.
                              enum:
                              - MANDATORY_NOT_FOUND
                            message:
                              type: string
                              description: Error message.
                              maxLength: 255
                            details:
                              type: object
                              description: Error details.
                              additionalProperties: false
                              properties:
                                api_name:
                                  type: string
                                  description: API name of the field.
                                  maxLength: 100
                                json_path:
                                  type: string
                                  description: JSON path to the field.
                                  maxLength: 255
                              required:
                              - api_name
                              - json_path
                            status:
                              type: string
                              description: Error status.
                              enum:
                              - error
                          required:
                          - code
                          - message
                          - details
                          - status
                        - type: object
                          description: Invalid data error.
                          additionalProperties: false
                          properties:
                            code:
                              type: string
                              description: Error code.
                              enum:
                              - INVALID_DATA
                            message:
                              type: string
                              description: Error message.
                              maxLength: 255
                            details:
                              type: object
                              description: Error details.
                              additionalProperties: false
                              properties:
                                id:
                                  type: string
                                  description: ID of the invalid record.
                                  maxLength: 19
                                api_name:
                                  type: string
                                  description: API name of the field.
                                  maxLength: 100
                                json_path:
                                  type: string
                                  description: JSON path to the field.
                                  maxLength: 255
                              required:
                              - api_name
                              - json_path
                            status:
                              type: string
                              description: Error status.
                              enum:
                              - error
                          required:
                          - code
                          - message
                          - details
                          - status
                        - type: object
                          description: Duplicate data error.
                          additionalProperties: false
                          properties:
                            code:
                              type: string
                              description: Error code.
                              enum:
                              - DUPLICATE_DATA
                            message:
                              type: string
                              description: Error message.
                              maxLength: 255
                            details:
                              type: object
                              description: Error details.
                              additionalProperties: false
                              properties:
                                id:
                                  type: string
                                  description: ID of the duplicate record.
                                  maxLength: 19
                                api_name:
                                  type: string
                                  description: API name of the field.
                                  maxLength: 100
                                json_path:
                                  type: string
                                  description: JSON path to the field.
                                  maxLength: 255
                              required:
                              - api_name
                              - json_path
                            status:
                              type: string
                              description: Error status.
                              enum:
                              - error
                          required:
                          - code
                          - message
                          - details
                          - status
                        - type: array
                          description: Array of duplicate data errors
                          maxItems: 100
                          items:
                            type: object
                            description: Duplicate data error details
                            additionalProperties: false
                            properties:
                              status:
                                type: string
                                description: Error status
                                enum:
                                - error
                              code:
                                type: string
                                description: Error code
                                enum:
                                - DUPLICATE_DATA
                              message:
                                type: string
                                description: Error message
                                maxLength: 255
                              details:
                                oneOf:
                                - type: object
                                  description: Duplicate data error details with ID
                                  additionalProperties: false
                                  properties:
                                    id:
                                      type: string
                                      description: ID of the duplicate record
                                      maxLength: 19
                                    api_name:
                                      type: string
                                      description: API name of the field
                                      maxLength: 100
                                    json_path:
                                      type: string
                                      description: JSON path to the field
                                      maxLength: 255
                                  required:
                                  - id
                                  - api_name
                                  - json_path
                                - type: object
                                  description: Duplicate data error details without ID
                                  additionalProperties: false
                                  properties:
                                    api_name:
                                      type: string
                                      description: API name of the field
                                      maxLength: 100
                                    json_path:
                                      type: string
                                      description: JSON path to the field
                                      maxLength: 255
                                  required:
                                  - api_name
                                  - json_path
                            required:
                            - status
                            - code
                            - message
                            - details
                  required:
                  - contact_roles
      security:
      - iam-oauth2-schema:
        - ZohoCRM.modules.contacts.UPDATE
      tags:
      - Contacts
    delete:
      summary: Delete Contact Roles
      description: Deletes one or more contact roles by their IDs.
      operationId: deleteRoles
      parameters:
      - $ref: '#/components/parameters/Ids'
      responses:
        '200':
          description: Contact role deleted successfully
          content:
            application/json:
              schema:
                type: object
                description: Response object for successful contact role deletion.
                additionalProperties: false
                properties:
                  contact_roles:
                    type: array
                    description: Array of contact role deletion results
                    maxItems: 100
                    items:
                      type: object
                      description: Contact role deletion result details.
                      additionalProperties: false
                      properties:
                        code:
                          type: string
                          description: Status code for the operation.
                          enum:
                          - SUCCESS
                        details:
                          type: object
                          description: Details of the deleted contact role.
                          additionalProperties: false
                          properties:
                            id:
                              type: string
                              description: Unique identifier for the deleted contact role.
                              maxLength: 19
                          required:
                          - id
                        message:
                          type: string
                          description: Operation message.
                          maxLength: 255
                        status:
                          type: string
                          description: Operation status.
                          enum:
                          - success
                      required:
                      - code
                      - details
                      - message
                      - status
                required:
                - contact_roles
        '400':
          description: Error in deleting contact roles
          content:
            application/json:
              schema:
                oneOf:
                - type: object
                  description: Error response wrapper for contact role delete failures
                  additionalProperties: false
                  properties:
                    contact_roles:
                      type: array
                      description: Array of error responses for contact roles
                      maxItems: 100
                      items:
                        oneOf:
                        - type: object
                          description: Invalid data error
                          additionalProperties: false
                          properties:
                            code:
                              type: string
                              description: Error code
                              enum:
                              - INVALID_DATA
                            message:
                              type: string
                              description: Error message
                              maxLength: 255
                            details:
                              type: object
                              description: Error details
                              additionalProperties: false
                              properties:
                                id:
                                  type: string
                                  description: ID of the invalid record
                                  maxLength: 19
                              required:
                              - id
                            status:
                              type: string
                              description: Error status
                              enum:
                              - error
                          required:
                          - code
                          - message
                          - details
                          - status
                        - type: object
                          description: Lower limit reached error
                          additionalProperties: false
                          properties:
                            status:
                              type: string
                              description: Error status
                              enum:
                              - error
                            code:
                              type: string
                              description: Error code
                              enum:
                              - LOWER_LIMIT_REACHED
                            message:
                              type: string
                              description: Error message
                              maxLength: 255
                            details:
                              type: object
                              description: Error details
                              additionalProperties: false
                              properties:
                                limit:
                                  type: integer
                                  format: int32
                                  description: Limit value
                                id:
                                  type: string
                                  description: ID of the record
                                  maxLength: 19
                              required:
                              - limit
                              - id
                          required:
                          - status
                          - code
                          - message
                          - details
                  required:
                  - contact_roles
                - type: object
                  description: Required parameter missing error response
                  additionalProperties: false
                  properties:
                    code:
                      type: string
                      description: Error code
                      enum:
                      - REQUIRED_PARAM_MISSING
                    message:
                      type: string
                      description: Error message
                      maxLength: 255
                    details:
                      type: object
                      description: Error details
                      additionalProperties: false
                      properties:
                        param_name:
                          type: string
                          description: Name of the missing required parameter
                          maxLength: 100
                      required:
                      - param_name
                    status:
                      type: string
                      description: Error status
                      enum:
                      - error
                  required:
                  - code
                  - message
                  - details
                  - status
      security:
      - iam-oauth2-schema:
        - ZohoCRM.modules.contacts.DELETE
      tags:
      - Contacts
    servers:
    - url: https://zohoapis.{dc}/crm/{version}
      description: API Server URL
      variables:
    

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