---
title: "Send Transactional Email"
method: POST
path: "/emails/transactional"
tags: ["Emails"]
---

# Send Transactional Email

`POST /emails/transactional`

Send transactional emails (recipients will be known to each other). Required Access Level: SendHttp

## Request body

- EmailTransactionalMessageData — Email data
  - `Recipients` TransactionalRecipient, required — List of transactional recipients
    - `To` string[], required — List of recipients (visible to others)
    - `CC` string[] — List of Carbon Copy recipients (visible to others)
    - `BCC` string[] — List of Blind Carbon Copy recipients (hidden from other recipients)
  - `Content` EmailContent, required — Proper e-mail content
    - `Body` BodyPart[] — List of e-mail body parts, with user-provided MIME types (text/html, text/plain etc)
      - `ContentType` 'HTML' | 'PlainText' | 'AMP' | 'CSS', required — Type of body part
      - `Content` string, string — Actual content of the body part
      - `Charset` string, string — Text value of charset encoding for example: iso-8859-1, windows-1251, utf-8, us-ascii, windows-1250 and more...
    - `Merge` object — A key-value collection of custom merge fields, shared between recipients. Should be used in e-mail body like so: {firstname}, {lastname} etc.
    - `Attachments` MessageAttachment[] — Attachments provided by sending binary data
      - `BinaryContent` string, byte, required — File's content as byte array (or a Base64 string)
      - `Name` string, string, required — Display name of the file
      - `ContentType` string, string — MIME content type
      - `Size` integer — Size of your attachment (in bytes).
    - `Headers` object — A key-value collection of custom e-mail headers.
    - `Postback` string, string — Postback header.
    - `EnvelopeFrom` string, string — E-mail with an optional name to be used as the envelope from address (e.g.: John Doe <email@domain.com>)
    - `From` string, string, required — Your e-mail with an optional name (e.g.: John Doe <email@domain.com>)
    - `ReplyTo` string, string — To what address should the recipients reply to (e.g. John Doe <email@domain.com>)
    - `Subject` string, string — Default subject of email.
    - `TemplateName` string, string — Name of template.
    - `AttachFiles` string[] — Names of previously uploaded files that should be sent as downloadable attachments
    - `Utm` Utm — Utm marketing data to be attached to every link in this e-mail.
      - `Source` string, string — utmsource value
      - `Medium` string, string — utmmedium value
      - `Campaign` string, string — utmcampaign value
      - `Content` string, string — utmcontent value
  - `Options` Options — E-mail configuration
    - `TimeOffset` integer, nullable — By how long should an e-mail be delayed (in minutes). Maximum is 35 days.
    - `PoolName` string, string — Name of your custom IP Pool to be used in the sending process
    - `ChannelName` string, string — Name of selected channel.
    - `Encoding` 'UserProvided' | 'None' | 'Raw7bit' | 'Raw8bit' | 'QuotedPrintable' | 'Base64' | 'Uue' — Encoding type for the email headers
    - `TrackOpens` boolean, nullable — Should the opens be tracked? If no value has been provided, Account's default setting will be used.
    - `TrackClicks` boolean, nullable — Should the clicks be tracked? If no value has been provided, Account's default setting will be used.

## Response `200`

OK

- EmailSend
  - `TransactionID` string, string — ID number of transaction
  - `MessageID` string, string — Unique identifier for this email.

---

[API](https://skmtc.net/elasticemail/apis/megamail-api.md) · [All operations](https://skmtc.net/elasticemail/apis/megamail-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elasticemail/megamail-api/versions/1a0ebb83f676/schema)