Send Batch Emails Using Template
Send a batch of transactional emails to multiple recipients using a pre-created CPaaS template.
Endpoint
Request URL
https://cpaas.zoho.com/v1.1/email/template/batch Copied!
Request Parameters
- Request Headers
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
Show Sub-Attributes
Unique key of the email template. Use either template_key or template_alias.
Alias of the email template. Use either template_alias or template_key.
The sender's email address and optional display name.
List of recipients. Each recipient can have individual merge info.
Array of CC recipient email addresses.
Array of BCC recipient email addresses.
Reply-to email address.
Array of file attachments.
Base64-encoded file content.
Enable or disable click tracking.
Enable or disable open tracking.
Sample Request
curl --request POST \
--url https://cpaas.zoho.com/v1.1/email/template/batch \
--header 'Authorization: REPLACE_KEY_VALUE' \
--header 'content-type: application/json' \
--data '{"template_key":"1234567890","template_alias":"account-confirmation","from":{"address":"accounts@info.zylker.com","name":"Paula"},"to":[{"email_address":{"address":"accounts@info.zylker.com","name":"accounts"},"merge_info":{"property1":"string","property2":"string"}}],"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"}],"attachments":[{"file_cache_key":"fc-xxxx-xxxx","mime_type":"application/pdf","name":"invoice.pdf","content":"string"}],"track_clicks":true,"track_opens":true}'Sample Request Body
{
"template_key": "1234567890",
"template_alias": "account-confirmation",
"from": {
"address": "accounts@info.zylker.com",
"name": "Paula"
},
"to": [
{
"email_address": {
"address": "accounts@info.zylker.com",
"name": "accounts"
},
"merge_info": {
"property1": "string",
"property2": "string"
}
}
],
"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"
}
],
"attachments": [
{
"file_cache_key": "fc-xxxx-xxxx",
"mime_type": "application/pdf",
"name": "invoice.pdf",
"content": "string"
}
],
"track_clicks": true,
"track_opens": true
}
Response Parameters
- HTTP code 200
Response Body - application/json
Show Sub-Attributes
- HTTP code 400
Response Body - application/json
Show Sub-Attributes
Show Sub-Attributes
Sample Response: HTTP 200
{
"data": [
{
"code": "EM_104",
"message": "OK"
}
],
"message": "OK",
"request_id": "req-xxxx"
}
Sample Response: HTTP 400
{
"data": {
"error_code": "TM_3004",
"message": "Invalid request"
},
"message": "error"
}
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.