---
title: "Send email"
method: POST
path: "/email/send"
tags: ["email"]
---

# Send email

`POST /email/send`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/email/send`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Send one raw email (no campaign): to/cc/bcc, custom from-name and reply-to, optional reply threading via replyToMessageId.

## Request body

- object
  - `fromEmail` string, required: Verified sender mailbox.
  - `fromName` string: Display name override.
  - `to` object[], required: Primary recipients. to+cc+bcc is capped at 50.
    - `email` string, required: Recipient email address.
    - `name` string: Optional display name.
  - `cc` object[]
    - `email` string, required: Recipient email address.
    - `name` string: Optional display name.
  - `bcc` object[]
    - `email` string, required: Recipient email address.
    - `name` string: Optional display name.
  - `replyToEmail` string
  - `subject` string, required
  - `htmlBody` string: HTML body. Provide htmlBody and/or textBody.
  - `textBody` string
  - `replyToMessageId` string: Dench messageId or RFC 5322 Message-ID to thread this send as a reply.
  - `configurationSetName` string

## Response `200`

Successful response

- object
  - `ok` boolean, required
  - `messageId` string, required: Dench message id for `dench email message status`.
  - `providerMessageId` string, required
  - `rfcMessageId` string: RFC 5322 Message-ID usable for reply threading.
  - `recipients` number, required
  - `status` 'sent', required
  - `inReplyTo` string
  - `message` string, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)