Send Email

Send a transactional email to one or more recipients.

Endpoint

post /email

Copy full URL

Request URL

https://cpaas.zoho.com/v1.1/email 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

htmlbodystringOptional

HTML content of the email body.

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.

subjectstringMandatory

Subject line of the email.

inline_imagesarrayOptional

Array of inline images embedded in the email body.

mime_typestringOptional

namestringOptional

contentstringOptional

Base64-encoded image content.

cidstringOptional

track_opensbooleanOptional

Enable or disable open tracking.

reply_toarrayOptional

Reply-to email address.

addressstringOptional

namestringOptional

mime_headersobjectOptional

Custom MIME headers to add to the email.

fromobjectMandatory

The sender's email address and optional display name.

addressstringMandatory

namestringOptional

toarrayMandatory

Array of recipient email addresses.

email_addressJSON ObjectOptional

Show Sub-Attributes

addressstringOptional

namestringOptional

textbodystringOptional

Plain text content of the email body.

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 \
  --header 'Authorization: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"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":[{"file_cache_key":"fc-xxxx-xxxx","mime_type":"application/pdf","name":"invoice.pdf","content":"string"}],"subject":"Account Confirmation","inline_images":[{"mime_type":"image/png","name":"logo.png","content":"string","cid":"logo"}],"track_opens":true,"reply_to":[{"address":"support@zylker.com","name":"Support"}],"mime_headers":{"property1":"string","property2":"string"},"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}'

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"))
        .header("content-type", "application/json")
        .header("Authorization", "REPLACE_KEY_VALUE")
        .method("POST", HttpRequest.BodyPublishers.ofString("{\"cc\":[{\"email_address\":{\"address\":\"manager@zylker.com\",\"name\":\"Manager\"}}],\"htmlbody\":\"Kindly click on Verify Account to confirm your account.\",\"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\"}],\"subject\":\"Account Confirmation\",\"inline_images\":[{\"mime_type\":\"image/png\",\"name\":\"logo.png\",\"content\":\"string\",\"cid\":\"logo\"}],\"track_opens\":true,\"reply_to\":[{\"address\":\"support@zylker.com\",\"name\":\"Support\"}],\"mime_headers\":{\"property1\":\"string\",\"property2\":\"string\"},\"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}"))
        .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\"}}],\"htmlbody\":\"Kindly click on Verify Account to confirm your account.\",\"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\"}],\"subject\":\"Account Confirmation\",\"inline_images\":[{\"mime_type\":\"image/png\",\"name\":\"logo.png\",\"content\":\"string\",\"cid\":\"logo\"}],\"track_opens\":true,\"reply_to\":[{\"address\":\"support@zylker.com\",\"name\":\"Support\"}],\"mime_headers\":{\"property1\":\"string\",\"property2\":\"string\"},\"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}"

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

conn.request("POST", "/v1.1/email", 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("htmlbody","Kindly click on Verify Account to confirm your account.");
    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.put("subject","Account Confirmation");
    data_inline_images=List();
    data_inline_images_item1=Map();
    data_inline_images_item1.put("mime_type","image/png");
    data_inline_images_item1.put("name","logo.png");
    data_inline_images_item1.put("content","value");
    data_inline_images_item1.put("cid","logo");
    data_inline_images.add(data_inline_images_item1);
    data.put("inline_images",data_inline_images);
    data.put("track_opens",true);
    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_mime_headers=Map();
    data.put("mime_headers",data_mime_headers);
    data_from=Map();
    data_from.put("address","accounts@info.zylker.com");
    data_from.put("name","Paula");
    data.put("from",data_from);
    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("textbody","Kindly click on Verify Account to confirm your account.");
    data.put("track_clicks",true);

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

    info response;

Sample Request Body

Copied!

  {
    "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": [
      {
        "file_cache_key": "fc-xxxx-xxxx",
        "mime_type": "application/pdf",
        "name": "invoice.pdf",
        "content": "string"
      }
    ],
    "subject": "Account Confirmation",
    "inline_images": [
      {
        "mime_type": "image/png",
        "name": "logo.png",
        "content": "string",
        "cid": "logo"
      }
    ],
    "track_opens": true,
    "reply_to": [
      {
        "address": "support@zylker.com",
        "name": "Support"
      }
    ],
    "mime_headers": {
      "property1": "string",
      "property2": "string"
    },
    "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
  }

▼ Show full

Response Parameters

- HTTP code 200

Response Body - application/json

JSON Object

Show Sub-Attributes

dataJSON Array

Show Sub-Attributes

codestring

additional_infoJSON Array

Show Sub-Attributes

toJSON Object

Show Sub-Attributes

email_addressJSON Object

Show Sub-Attributes

addressstring

namestring

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",
        "additional_info": [
          {
            "to": {
              "email_address": {}
            }
          }
        ],
        "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