---
title: "Send an email"
method: POST
path: "/message-handler/send-email"
tags: ["Email"]
---

# Send an email

`POST /message-handler/send-email`

## Request body

- SendEmailDTO
  - `to` string, required — The recipient email address
  - `from` string, required — The sender email address
  - `template` string, required — The email template ID
  - `context` object — Key-value pairs to populate the email template. The keys must be the names of the variables in the template used for the email.
  - `subject` string, required — The subject line
  - `account` string — Account ID. This is required to define which localized template should be used. If account ID is not specified, the organization's default localization is used.

## Response `200`

Successful response

- ResponseEmailSent — Description of the sent email message
  - `accepted` string[], required — A list of email addresses that have accepted the email message
  - `rejected` string[], required — A list of email addresses that rejected the email message
  - `envelopeTime` number, required — The time to process the email envelope
  - `messageTime` number, required — The time to process the email message
  - `messageSize` number, required — The email message size
  - `response` string, required — Response
  - `envelope` EmailResponseEnvelopeDTO, required
    - `from` string, required — The sender email address
    - `to` string[], required — Array of recipient email addresses
  - `messageId` string, required — The unique identifier assigned to the email message

---

[API](https://skmtc.net/fanhero/apis/tenant-endpoints.md) · [All operations](https://skmtc.net/fanhero/apis/tenant-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanhero/tenant-endpoints/versions/8e7584c449dc/schema)