---
title: "Send Email"
method: POST
path: "/v1.0/message/email/send"
tags: ["Communication"]
---

# Send Email

`POST /v1.0/message/email/send`

Sends an email to the specified lead using the caller's outgoing email configuration.

Notes:
- leadId, subject and content are required.
- toEmail selects a specific email on the lead; when it is not present on the lead, the lead's primary email is used.
- Caller must have manage permission on the lead.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- EmailSendRequest — Email send request payload.
  - `subject` string, required — Email subject
  - `content` string, required — Email content
  - `leadId` integer, required — Lead ID. When toEmail is not provided or no matching email is found for the lead, the system will use the primary email address of this lead. At least one of toEmail or leadId must be provided.
  - `toEmail` string — Recipient email address.

## Response `200`

Email delivered. Response contains the message ID, subject and destination.

- EmailSendResponse
  - `messageId` string — The ID of the email message
  - `toEmail` string — Recipient email address
  - `subject` string — Email subject

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid authentication token.
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)