Zoho Emails API

The Emails API from Zoho — 2 operation(s) for emails.

Operations 2

GET /{module}/{recordId}/Emails/actions/download_attachments Get Download Attachments Details #
GET /{module}/{recordId}/Emails/actions/download_inline_images Download inline images embedded in an email related to a record #

Documentation

Specifications

Code Examples

Other Resources

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-emails-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

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

OpenAPI Specification

zoho-emails-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Helpcenter Emails API
  version: 1.0.0
tags:
- name: Emails
paths:
  /{module}/{recordId}/Emails/actions/download_attachments:
    get:
      summary: Get Download Attachments Details
      description: Fetches the binary content of an email attachment for a specific record.
      operationId: downloadEmailAttachments
      parameters:
      - $ref: '#/components/parameters/Module'
      - $ref: '#/components/parameters/RecordId'
      - $ref: '#/components/parameters/UserId'
      - $ref: '#/components/parameters/MessageId'
      - $ref: '#/components/parameters/Id'
      - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Attachment downloaded successfully
          content:
            application/octet-stream:
              schema:
                description: Binary stream of the attachment file.
                type: string
                format: binary
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                description: Error response for validation or missing parameters.
                oneOf:
                - description: Generic validation error schema.
                  type: object
                  additionalProperties: false
                  properties:
                    status:
                      type: string
                      description: Error status
                      enum:
                      - error
                    code:
                      type: string
                      description: Error code
                      maxLength: 50
                    message:
                      type: string
                      description: Error message
                      maxLength: 500
                    details:
                      type: object
                      description: Context details
                      additionalProperties: true
                  required:
                  - status
                  - code
                  - message
                - description: Error for missing mandatory fields.
                  type: object
                  additionalProperties: false
                  properties:
                    status:
                      type: string
                      description: Status
                      enum:
                      - error
                    code:
                      type: string
                      description: Code
                      const: MANDATORY_NOT_FOUND
                    message:
                      type: string
                      description: Message
                      maxLength: 500
                  required:
                  - status
                  - code
                  - message
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - iam-oauth2-schema:
        - ZohoCRM.modules.emails.READ
        - ZohoCRM.modules.leads.READ
      tags:
      - Emails
  /{module}/{recordId}/Emails/actions/download_inline_images:
    get:
      summary: Download inline images embedded in an email related to a record
      operationId: getDownloadInlineImages
      description: Download inline images embedded in an email related to a record.
      parameters:
      - $ref: '#/components/parameters/Module_2'
      - $ref: '#/components/parameters/RecordId_2'
      - $ref: '#/components/parameters/UserId_2'
      - $ref: '#/components/parameters/MessageId_2'
      - $ref: '#/components/parameters/Id_2'
      responses:
        '200':
          description: The inline image file.
          content:
            image/png:
              schema:
                type: string
                format: binary
                description: The binary content of the image file
        '400':
          description: Bad Request - Error in parameters or module.
          content:
            application/json:
              schema:
                description: Error response object for failed image download
                type: object
                additionalProperties: false
                properties:
                  status:
                    type: string
                    description: Status of the request
                    enum:
                    - error
                  code:
                    type: string
                    description: Error code identifying the issue
                    enum:
                    - INVALID_URL_PATTERN
                    - INVALID_DATA
                    - INVALID_REQUEST_METHOD
                    - INVALID_TOKEN
                    - INVALID_MODULE
                  message:
                    type: string
                    description: Human-readable error message
                    maxLength: 255
                  details:
                    type: object
                    description: Additional error details
                    additionalProperties: true
                    properties:
                      resource_path_index:
                        type: integer
                        format: int32
                        description: Index of the resource path causing the error
                required:
                - status
                - code
                - message
                - details
      security:
      - iam-oauth2-schema:
        - ZohoCRM.modules.emails.READ
        - ZohoCRM.modules.leads.all
        - ZohoCRM.modules.contacts.all
        - ZohoCRM.modules.deals.all
      tags:
      - Emails
components:
  parameters:
    MessageId:
      name: message_id
      in: query
      required: true
      description: The ID of the email message.
      schema:
        type: string
        maxLength: 100
    RecordId_2:
      name: recordId
      in: path
      required: true
      description: The unique ID of the record.
      schema:
        type: string
        maxLength: 100
    Module_2:
      name: module
      in: path
      required: true
      description: The API name of the module.
      schema:
        type: string
        maxLength: 50
    Module:
      name: module
      in: path
      required: true
      description: The API name of the CRM module.
      schema:
        type: string
        maxLength: 100
    UserId_2:
      name: user_id
      in: query
      required: true
      description: The unique ID of the record owner.
      schema:
        type: string
        maxLength: 100
    Name:
      name: name
      in: query
      required: true
      description: The attachment name.
      schema:
        type: string
        maxLength: 255
    MessageId_2:
      name: message_id
      in: query
      required: true
      description: The message ID from the email response.
      schema:
        type: string
        maxLength: 100
    Id:
      name: id
      in: query
      required: true
      description: The attachment ID.
      schema:
        type: string
        maxLength: 100
    Id_2:
      name: id
      in: query
      required: true
      description: The unique ID of the inline image attachment.
      schema:
        type: string
        maxLength: 100
    UserId:
      name: user_id
      in: query
      required: true
      description: The ID of the user.
      schema:
        type: string
        maxLength: 20
    RecordId:
      name: recordId
      in: path
      required: true
      description: The unique record ID.
      schema:
        type: string
        maxLength: 20
  schemas:
    ErrorResponse:
      description: Standard Zoho CRM error response structure.
      type: object
      additionalProperties: false
      properties:
        status:
          type: string
          description: Status
          enum:
          - error
        code:
          type: string
          description: Error code
          maxLength: 100
        message:
          type: string
          description: Error message
          maxLength: 1000
        details:
          type: object
          description: Details
          additionalProperties: true
      required:
      - status
      - code
      - message
  securitySchemes:
    iam-oauth2-schema:
      $ref: ./Common.json#/components/securitySchemes/iam-oauth2-schema
x-entity: Helpcenter