---
title: "Send Email"
method: POST
path: "/email"
tags: ["email management"]
---

# Send Email

`POST /email`

## Request

- Base URL: `https://cpaas.zoho.com/v1.1`
- URL: `https://cpaas.zoho.com/v1.1/email`
- Auth: API key in header `Authorization`

Send a transactional email to one or more recipients.

## Request body

- object
  - `cc` object[]: Array of CC recipient email addresses.
    - `email_address` object
      - `address` string
      - `name` string
  - `htmlbody` string: HTML content of the email body.
  - `client_reference` string: A custom reference string to identify the email in your system.
  - `bcc` object[]: Array of BCC recipient email addresses.
    - `email_address` object
      - `address` string
      - `name` string
  - `attachments` object[]: Array of file attachments. For each attachment supply EITHER `content` (inline base64) OR `file_cache_key` (a key returned by the file-upload API) — the two are mutually exclusive. If both are present, `file_cache_key` takes precedence and `content` is ignored. When `content` is used, `name` and `mime_type` are required; when `file_cache_key` is used, `name` is optional.
    - `file_cache_key` string: Key of a file previously uploaded via the file-upload API (POST /v1.1/files). Required unless `content` is provided. Mutually exclusive with `content`.
    - `mime_type` string: MIME type of the file. Required when `content` is used.
    - `name` string: File name shown to the recipient. Required when `content` is used; optional with `file_cache_key`.
    - `content` string: Base64-encoded file content. Required unless `file_cache_key` is provided. Mutually exclusive with `file_cache_key`.
  - `subject` string, required: Subject line of the email.
  - `bounce_address` string, email: Verified bounce (Return-Path) address that receives bounce notifications for this email. Must be a bounce address created and verified under the sending agent's domain.
  - `inline_images` object[]: Array of images embedded in the HTML body. Reference each image from `htmlbody` using its `cid`, e.g. `<img src="cid:logo">`. For each image supply EITHER `content` (inline base64) OR `file_cache_key` — the two are mutually exclusive; if both are present `file_cache_key` takes precedence and `content` is ignored. `cid` is always required. When `content` is used, `mime_type` is also required and `name` is optional; when `file_cache_key` is used, only `cid` is required.
    - `file_cache_key` string: Key of an image previously uploaded via the file-upload API (POST /v1.1/files). Required unless `content` is provided. Mutually exclusive with `content`.
    - `mime_type` string: MIME type of the image. Required when `content` is used.
    - `name` string: Optional file name for the image. When omitted with `content`, a name is derived from the `cid` and `mime_type`.
    - `content` string: Base64-encoded image content. Required unless `file_cache_key` is provided. Mutually exclusive with `file_cache_key`.
    - `cid` string: Content-ID referenced from the HTML body via `<img src="cid:...">`. Always required.
  - `track_opens` boolean: Enable or disable open tracking.
  - `reply_to` object[]: Reply-to email address.
    - `address` string
    - `name` string
  - `mime_headers` MimeHeaders: Custom MIME headers as a flat JSON object of header name to string value. Use custom (for example `X-` prefixed) headers for your own metadata. Reserved headers such as Content-Type, From, To, Subject and Date cannot be overridden.
  - `from` FromAddress, required: The sender's email address and optional display name.
    - `address` string, required
    - `name` string
  - `to` object[], required: Array of recipient email addresses.
    - `email_address` object, required
      - `address` string, required
      - `name` string
  - `textbody` string: Plain text content of the email body.
  - `track_clicks` boolean: Enable or disable click tracking.

## Response `200`

Email sent successfully.

- object
  - `data` object[]
    - `code` string
    - `additional_info` object[]
      - `to` object
        - `email_address` object
          - `address` string
          - `name` string
    - `message` string
  - `message` string
  - `request_id` string

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/zoho/apis/zoho-cpaas.md) - [All operations](https://skmtc.dev/zoho/apis/zoho-cpaas/llms.txt) - [OpenAPI document](https://skmtc.dev/zoho/apis/zoho-cpaas/revisions/f0858a38e8b0?raw)