Skip to main content
POST
/
transactional
/
send-message
curl -X POST https://api2.ecomailapp.cz/transactional/send-message \
  -H "key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": {
      "subject": "Email subject",
      "from_name": "Sender'\''s name",
      "from_email": "foo@bar.cz",
      "reply_to": "foo@bar.cz",
      "text": "Plain text content",
      "html": "<b>Email HTML content</b>",
      "to": [
        {
          "email": "to@me.com",
          "name": "Recipient'\''s name",
          "cc": "cc@me.com",
          "bcc": "bcc@me.com"
        }
      ],
      "global_merge_vars": [
        {"name": "mergeTagName", "content": "mergeTagValue"}
      ],
      "attachments": [
        {
          "type": "mime/type",
          "name": "attachment-name.pdf",
          "content": "base64encodedcontent"
        }
      ],
      "options": {
        "click_tracking": true,
        "open_tracking": true
      }
    }
  }'

{
  "results": {
    "total_rejected_recipients": 0,
    "total_accepted_recipients": 2,
    "id": 11668787484950529
  }
}
Transactional emails are only available for paid accounts with a verified sending domain.
The total data limit for sent merge tags is 100,000 bytes. Message size including attachments must be under 4 MB.
Reserved variables that cannot be used as merge tag names: address.name, email, email_id, address.email, env_from.
When using HTML code in global merge vars, use curly braces around the tag in HTML content: {*|htmlcode|*} renders the HTML, while *|htmlcode|* shows raw HTML.
To send to multiple CC/BCC recipients, include multiple objects in the to array with the same email but different cc/bcc values.
​
message
object
required
The message object containing all email details.
curl -X POST https://api2.ecomailapp.cz/transactional/send-message \
  -H "key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": {
      "subject": "Email subject",
      "from_name": "Sender'\''s name",
      "from_email": "foo@bar.cz",
      "reply_to": "foo@bar.cz",
      "text": "Plain text content",
      "html": "<b>Email HTML content</b>",
      "to": [
        {
          "email": "to@me.com",
          "name": "Recipient'\''s name",
          "cc": "cc@me.com",
          "bcc": "bcc@me.com"
        }
      ],
      "global_merge_vars": [
        {"name": "mergeTagName", "content": "mergeTagValue"}
      ],
      "attachments": [
        {
          "type": "mime/type",
          "name": "attachment-name.pdf",
          "content": "base64encodedcontent"
        }
      ],
      "options": {
        "click_tracking": true,
        "open_tracking": true
      }
    }
  }'

{
  "results": {
    "total_rejected_recipients": 0,
    "total_accepted_recipients": 2,
    "id": 11668787484950529
  }
}