email management

Send Batch Emails

Send a batch of transactional emails to multiple recipients at once.

post/email/batch

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.

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",
  "track_opens": true,
  "reply_to": [
    {
      "address": "support@zylker.com",
      "name": "Support"
    }
  ],
  "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

Batch email sent successfully.

messagestring
request_idstring

Example response

{
  "data": [
    {
      "code": "EM_104",
      "message": "OK"
    }
  ],
  "message": "OK",
  "request_id": "req-xxxx"
}

Changes

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