ZOzoho
email management

Send Email

Send a transactional email to one or more recipients.

post/email

Request

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

Request body

htmlbodystring

HTML content of the email body.

client_referencestring

A custom reference string to identify the email in your system.

subjectstring required

Subject line of the email.

bounce_addressstring 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.

track_opensboolean

Enable or disable open tracking.

mime_headersMimeHeaders

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.

textbodystring

Plain text content of the email body.

track_clicksboolean

Enable or disable click tracking.

Example request

{
  "cc": [
    {
      "email_address": {
        "address": "manager@zylker.com",
        "name": "Manager"
      }
    }
  ],
  "htmlbody": "<div><b>Kindly click on Verify Account to confirm your account.</b></div>",
  "client_reference": "order-12345",
  "bcc": [
    {
      "email_address": {
        "address": "archive@zylker.com",
        "name": "Archive"
      }
    }
  ],
  "attachments": [
    {
      "mime_type": "application/pdf",
      "name": "invoice.pdf",
      "content": "JVBERi0xLjQKJcTl8uXrp... (base64-encoded bytes)"
    },
    {
      "file_cache_key": "ea36f19a.a59e41437e3e1a1.h1.bbeabef0-d2c5-11f1-8876-2a30dd3b833c.1a18258b05f",
      "name": "terms.pdf"
    }
  ],
  "subject": "Account Confirmation",
  "bounce_address": "bounce@bounce-zem.zylker.com",
  "inline_images": [
    {
      "mime_type": "image/png",
      "name": "logo.png",
      "content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==",
      "cid": "logo"
    }
  ],
  "track_opens": true,
  "reply_to": [
    {
      "address": "support@zylker.com",
      "name": "Support"
    }
  ],
  "mime_headers": {
    "X-Campaign-Id": "camp-2026-10",
    "X-Custom-Tag": "transmail-qa"
  },
  "from": {
    "address": "accounts@info.zylker.com",
    "name": "Paula"
  },
  "to": [
    {
      "email_address": {
        "address": "rudra.d@zylker.com",
        "name": "Rudra"
      }
    }
  ],
  "textbody": "Kindly click on Verify Account to confirm your account.",
  "track_clicks": true
}

Response

Email sent successfully.

messagestring
request_idstring

Example response

{
  "data": [
    {
      "code": "EM_104",
      "additional_info": [
        {
          "to": {
            "email_address": {
              "address": "rudra.d@zylker.com",
              "name": "Rudra"
            }
          }
        }
      ],
      "message": "OK"
    }
  ],
  "message": "OK",
  "request_id": "req-xxxx"
}

Changes

No recorded changes to this operation across all 1 revision of this API.