Plain text content of the email body.
Send Batch Emails
Send a batch of transactional emails to multiple recipients at once.
Endpoint
Copy full URL
Request URL
https://cpaas.zoho.com/v1.1/email/batch Copied!
Request Parameters
- Request Headers
ApiKeyAuthAPI Key
API Key of an agent. Send the header as Authorization: Zoho-enczapikey {apiKey}.
Follow the steps here to generate an API key.
- Request Body
application/json
JSON Object
Show Sub-Attributes
fromobjectMandatory
The sender's email address and optional display name.
addressstringMandatory
Example
accounts@info.zylker.com
namestringOptional
Example
Paula
toarray[object]Mandatory
Array of recipient email addresses.
email_addressJSON ObjectOptional
ccarray[object]Optional
Array of CC recipient email addresses.
email_addressJSON ObjectOptional
bccarray[object]Optional
Array of BCC recipient email addresses.
email_addressJSON ObjectOptional
reply_toarray[object]Optional
Reply-to email address.
addressstringOptional
Example
support@zylker.com
namestringOptional
Example
Support
subjectstringMandatory
Subject line of the email.
Example
Account Confirmation
htmlbodystringOptional
HTML content of the email body.
Example
<div><b>Kindly click on Verify Account to confirm your account.</b></div>
textbodystringOptional
Example
Kindly click on Verify Account to confirm your account.
attachmentsarray[object]Optional
Array of file attachments.
file_cache_keystringOptional
Example
fc-xxxx-xxxx
mime_typestringOptional
Example
application/pdf
namestringOptional
Example
invoice.pdf
contentstringOptional
Base64-encoded file content.
track_clicksbooleanOptional
Enable or disable click tracking.
Example
true
track_opensbooleanOptional
Enable or disable open tracking.
Example
true
client_referencestringOptional
A custom reference string to identify the email in your system.
Example
order-12345
Sample Request
Curl
Java
Python
Deluge
Copied!
curl --request POST \
--url https://cpaas.zoho.com/v1.1/email/batch \
--header 'Authorization: REPLACE_KEY_VALUE' \
--header 'content-type: application/json' \
--data '{"from":{"address":"accounts@info.zylker.com","name":"Paula"},"to":[{"email_address":{"address":"rudra.d@zylker.com","name":"Rudra"}}],"cc":[{"email_address":{"address":"manager@zylker.com","name":"Manager"}}],"bcc":[{"email_address":{"address":"archive@zylker.com","name":"Archive"}}],"reply_to":[{"address":"support@zylker.com","name":"Support"}],"subject":"Account Confirmation","htmlbody":"<div><b>Kindly click on Verify Account to confirm your account.</b></div>","textbody":"Kindly click on Verify Account to confirm your account.","attachments":[{"file_cache_key":"fc-xxxx-xxxx","mime_type":"application/pdf","name":"invoice.pdf","content":"string"}],"track_clicks":true,"track_opens":true,"client_reference":"order-12345"}'Sample Request Body
Copied!
{
"from": {
"address": "accounts@info.zylker.com",
"name": "Paula"
},
"to": [
{
"email_address": {
"address": "rudra.d@zylker.com",
"name": "Rudra"
}
}
],
"cc": [
{
"email_address": {
"address": "manager@zylker.com",
"name": "Manager"
}
}
],
"bcc": [
{
"email_address": {
"address": "archive@zylker.com",
"name": "Archive"
}
}
],
"reply_to": [
{
"address": "support@zylker.com",
"name": "Support"
}
],
"subject": "Account Confirmation",
"htmlbody": "<div><b>Kindly click on Verify Account to confirm your account.</b></div>",
"textbody": "Kindly click on Verify Account to confirm your account.",
"attachments": [
{
"file_cache_key": "fc-xxxx-xxxx",
"mime_type": "application/pdf",
"name": "invoice.pdf",
"content": "string"
}
],
"track_clicks": true,
"track_opens": true,
"client_reference": "order-12345"
}
▼ Show full
Response Parameters
- HTTP code 200
Response Body - application/json
JSON Object
Show Sub-Attributes
dataarray[object]
messagestringread-only
Example
OK
request_idstringread-only
Example
req-xxxx
- HTTP code 400
Response Body - application/json
JSON Object
Show Sub-Attributes
dataJSON Object
Show Sub-Attributes
error_codestringread-only
Example
TM_3004
messagestringread-only
Example
Invalid request
messagestringread-only
Example
error
Sample Response: HTTP 200
Copied!
{
"data": [
{
"code": "EM_104",
"message": "OK"
}
],
"message": "OK",
"request_id": "req-xxxx"
}
▼ Show full
Sample Response: HTTP 400
Copied!
{
"data": {
"error_code": "TM_3004",
"message": "Invalid request"
},
"message": "error"
}
▼ Show full
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.