---
title: "Send Email message"
method: POST
path: "/api/v1/message/email"
tags: ["Messages"]
---

# Send Email message

`POST /api/v1/message/email`

The method is used for sending an Email message to a contact. A new contact is created if no contact with such email address exists.<br><br><strong>⚠️ Not recommended for OTP passwords.</strong> This method requires the full email HTML in the request body. Because of the content volume, such requests are not logged reliably, which makes delivery troubleshooting difficult.<br>Use the <a href="https://docs.esputnik.com/reference/sendextendedpreparedmessage-1">Send prepared message</a> method instead: the caller only passes substitution variables, the template is stored on our side, so the message is sent faster and all requests are logged correctly.

## Request body

- OutgoingEmail
  - `from` string, required — Sender address (enter one of the valid sender addresses). Address format: "\"name\" &lt;test@mail.com&gt;"
  - `subject` string, required — Message subject
  - `htmlText` string, required — Message HTML code
  - `plainText` string — Version of the message in plain text
  - `ampHtmlText` string — Message AMP HTML code
  - `emails` string[], required — The list of recipients
  - `tags` string[] — The list of tags assigned to the message
  - `externalRequestId` string — External request ID. It is the same for all the recipients
  - `skipPersonalisation` boolean — Skip the application of personalization to the message
  - `subscriptionsKeys` string[] — Array of subscription category keys added to the message
  - `trackUrls` boolean — The parameter determines whether to track links in the message or not. The default value is ‘true’

## Response `200`

---

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