Send Email Using Template

Send a transactional email using a pre-created CPaaS template.

Endpoint

post /email/template

Copy full URL

Request URL

https://cpaas.zoho.com/v1.1/email/template Copied!

Request Parameters

- Request Headers

ApiKeyAuthAPI Key

API key of an agent. Send the header as Authorization: Zoho-enczapikey {apiKey}. The agent and account are derived from the key.

- Request Body

application/json

JSON Object

Show Sub-Attributes

ccarrayOptional

Array of CC recipient email addresses.

email_addressJSON ObjectOptional

Show Sub-Attributes

addressstringOptional

namestringOptional

template_keystringOptional

Unique key of the email template. Use either template_key or template_alias.

client_referencestringOptional

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

bccarrayOptional

Array of BCC recipient email addresses.

email_addressJSON ObjectOptional

Show Sub-Attributes

addressstringOptional

namestringOptional

attachmentsarrayOptional

Array of file attachments.

file_cache_keystringOptional

mime_typestringOptional

namestringOptional

contentstringOptional

Base64-encoded file content.

reply_toarrayOptional

Reply-to email address.

addressstringOptional

namestringOptional

merge_infoobjectOptional

Key-value pairs to replace template variables.

fromobjectMandatory

The sender's email address and optional display name.

addressstringMandatory

namestringOptional

track_opensbooleanOptional

Enable or disable open tracking.

template_aliasstringOptional

Alias of the email template. Use either template_alias or template_key.

toarrayMandatory

Array of recipient email addresses.

email_addressJSON ObjectOptional

Show Sub-Attributes

addressstringOptional

namestringOptional

track_clicksbooleanOptional

Enable or disable click tracking.

Sample Request

Curl

Java

Python

Deluge

Copied!

curl --request POST \
  --url https://cpaas.zoho.com/v1.1/email/template \
  --header 'Authorization: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"cc":[{"email_address":{"address":"manager@zylker.com","name":"Manager"}}],"template_key":"1234567890","client_reference":"order-12345","bcc":[{"email_address":{"address":"archive@zylker.com","name":"Archive"}}],"attachments":[{"file_cache_key":"fc-xxxx-xxxx","mime_type":"application/pdf","name":"invoice.pdf","content":"string"}],"reply_to":[{"address":"support@zylker.com","name":"Support"}],"merge_info":{"account_id":"98765","user_name":"Rudra"},"from":{"address":"accounts@info.zylker.com","name":"Paula"},"track_opens":true,"template_alias":"account-confirmation","to":[{"email_address":{"address":"rudra.d@zylker.com","name":"Rudra"}}],"track_clicks":true}'

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;

public class Main {
  public static void main(String[] args) {

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://cpaas.zoho.com/v1.1/email/template"))
        .header("content-type", "application/json")
        .header("Authorization", "REPLACE_KEY_VALUE")
        .method("POST", HttpRequest.BodyPublishers.ofString("{\"cc\":[{\"email_address\":{\"address\":\"manager@zylker.com\",\"name\":\"Manager\"}}],\"template_key\":\"1234567890\",\"client_reference\":\"order-12345\",\"bcc\":[{\"email_address\":{\"address\":\"archive@zylker.com\",\"name\":\"Archive\"}}],\"attachments\":[{\"file_cache_key\":\"fc-xxxx-xxxx\",\"mime_type\":\"application/pdf\",\"name\":\"invoice.pdf\",\"content\":\"string\"}],\"reply_to\":[{\"address\":\"support@zylker.com\",\"name\":\"Support\"}],\"merge_info\":{\"account_id\":\"98765\",\"user_name\":\"Rudra\"},\"from\":{\"address\":\"accounts@info.zylker.com\",\"name\":\"Paula\"},\"track_opens\":true,\"template_alias\":\"account-confirmation\",\"to\":[{\"email_address\":{\"address\":\"rudra.d@zylker.com\",\"name\":\"Rudra\"}}],\"track_clicks\":true}"))
        .build();
    HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  
  }
}

import http.client

conn = http.client.HTTPSConnection("cpaas.zoho.com")

payload = "{\"cc\":[{\"email_address\":{\"address\":\"manager@zylker.com\",\"name\":\"Manager\"}}],\"template_key\":\"1234567890\",\"client_reference\":\"order-12345\",\"bcc\":[{\"email_address\":{\"address\":\"archive@zylker.com\",\"name\":\"Archive\"}}],\"attachments\":[{\"file_cache_key\":\"fc-xxxx-xxxx\",\"mime_type\":\"application/pdf\",\"name\":\"invoice.pdf\",\"content\":\"string\"}],\"reply_to\":[{\"address\":\"support@zylker.com\",\"name\":\"Support\"}],\"merge_info\":{\"account_id\":\"98765\",\"user_name\":\"Rudra\"},\"from\":{\"address\":\"accounts@info.zylker.com\",\"name\":\"Paula\"},\"track_opens\":true,\"template_alias\":\"account-confirmation\",\"to\":[{\"email_address\":{\"address\":\"rudra.d@zylker.com\",\"name\":\"Rudra\"}}],\"track_clicks\":true}"

headers = {
    'content-type': "application/json",
    'Authorization': "REPLACE_KEY_VALUE"
    }

conn.request("POST", "/v1.1/email/template", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))


    headersMap = Map();
    headersMap.put("Authorization", "REPLACE_KEY_VALUE");
    headersMap.put("Content-Type", "application/json");
    headersMap.put("Accept", "application/json");

    data=Map();
    data_cc=List();
    data_cc_item1=Map();
    data_cc_item1_email_address=Map();
    data_cc_item1_email_address.put("address","manager@zylker.com");
    data_cc_item1_email_address.put("name","Manager");
    data_cc_item1.put("email_address",data_cc_item1_email_address);
    data_cc.add(data_cc_item1);
    data.put("cc",data_cc);
    data.put("template_key","1234567890");
    data.put("client_reference","order-12345");
    data_bcc=List();
    data_bcc_item1=Map();
    data_bcc_item1_email_address=Map();
    data_bcc_item1_email_address.put("address","archive@zylker.com");
    data_bcc_item1_email_address.put("name","Archive");
    data_bcc_item1.put("email_address",data_bcc_item1_email_address);
    data_bcc.add(data_bcc_item1);
    data.put("bcc",data_bcc);
    data_attachments=List();
    data_attachments_item1=Map();
    data_attachments_item1.put("file_cache_key","fc-xxxx-xxxx");
    data_attachments_item1.put("mime_type","application/pdf");
    data_attachments_item1.put("name","invoice.pdf");
    data_attachments_item1.put("content","value");
    data_attachments.add(data_attachments_item1);
    data.put("attachments",data_attachments);
    data_reply_to=List();
    data_reply_to_item1=Map();
    data_reply_to_item1.put("address","support@zylker.com");
    data_reply_to_item1.put("name","Support");
    data_reply_to.add(data_reply_to_item1);
    data.put("reply_to",data_reply_to);
    data_merge_info=Map();
    data.put("merge_info",data_merge_info);
    data_from=Map();
    data_from.put("address","accounts@info.zylker.com");
    data_from.put("name","Paula");
    data.put("from",data_from);
    data.put("track_opens",true);
    data.put("template_alias","account-confirmation");
    data_to=List();
    data_to_item1=Map();
    data_to_item1_email_address=Map();
    data_to_item1_email_address.put("address","rudra.d@zylker.com");
    data_to_item1_email_address.put("name","Rudra");
    data_to_item1.put("email_address",data_to_item1_email_address);
    data_to.add(data_to_item1);
    data.put("to",data_to);
    data.put("track_clicks",true);

    response = invokeUrl
    [
        url: "https://cpaas.zoho.com/v1.1/email/template"
        type: POST
        headers: headersMap
        body: data
        connection: connection_name
    ]

    info response;

Sample Request Body

Copied!

  {
    "cc": [
      {
        "email_address": {
          "address": "manager@zylker.com",
          "name": "Manager"
        }
      }
    ],
    "template_key": "1234567890",
    "client_reference": "order-12345",
    "bcc": [
      {
        "email_address": {
          "address": "archive@zylker.com",
          "name": "Archive"
        }
      }
    ],
    "attachments": [
      {
        "file_cache_key": "fc-xxxx-xxxx",
        "mime_type": "application/pdf",
        "name": "invoice.pdf",
        "content": "string"
      }
    ],
    "reply_to": [
      {
        "address": "support@zylker.com",
        "name": "Support"
      }
    ],
    "merge_info": {
      "account_id": "98765",
      "user_name": "Rudra"
    },
    "from": {
      "address": "accounts@info.zylker.com",
      "name": "Paula"
    },
    "track_opens": true,
    "template_alias": "account-confirmation",
    "to": [
      {
        "email_address": {
          "address": "rudra.d@zylker.com",
          "name": "Rudra"
        }
      }
    ],
    "track_clicks": true
  }

▼ Show full

Response Parameters

- HTTP code 200

Response Body - application/json

JSON Object

Show Sub-Attributes

dataJSON Array

Show Sub-Attributes

codestring

messagestring

request_idstring

- HTTP code 400

Response Body - application/json

JSON Object

Show Sub-Attributes

dataJSON Object

Show Sub-Attributes

error_codestring

messagestring

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