---
title: "Send a real email"
method: POST
path: "/v1/emails"
tags: ["Sending"]
---

# Send a real email

`POST /v1/emails`

## Request

- Base URL: `https://api.usemektup.com`
- URL: `https://api.usemektup.com/v1/emails`
- Auth: HTTP bearer

The from address must be an existing mailbox on this account, or any address on a domain this account has verified (DNS-level proof of ownership, no per-address mailbox required). Identity signature is applied automatically when from is a provisioned mailbox.

## Request body

- object
  - `from` string, email, required
  - `to` string, email, required
  - `subject` string, required
  - `text` string: Plain-text body - text or html required
  - `html` string: HTML body - text or html required
  - `attachments` object[]
    - `filename` string, required
    - `contentType` string
    - `content` string, required: Base64-encoded, max 10MB decoded per attachment
  - `draftId` string, uuid: Deletes this draft on successful send
  - `replyTo` string, email: Sets the Reply-To header, e.g. a lead's own address

## Response `202`

Accepted for delivery

- object
  - `messageId` string
  - `envelope` object
    - `from` string
    - `to` string[]

## Other responses

- `400`: Invalid request
- `402`: Billing tier limit reached

---

[API](https://skmtc.dev/usemektup/apis/mektup-api.md) · [All operations](https://skmtc.dev/usemektup/apis/mektup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usemektup/apis/mektup-api/revisions/b64e649247e7?raw)