---
title: "Send an email"
method: POST
path: "/emails"
tags: ["Emails"]
---

# Send an email

`POST /emails`

## Request body

- SendEmailInput
  - `from` string, required — `Name <email@verified-domain>` or just `email@verified-domain`. The domain must be verified in your account.
  - `to` string[], required
  - `cc` string[]
  - `bcc` string[]
  - `reply_to` string, email
  - `subject` string
  - `html` string
  - `text` string
  - `headers` object
  - `tags` string[]
  - `attachments` Attachment[]
    - `filename` string, required
    - `content` string, required — base64-encoded file contents
    - `content_type` string — Defaults to inferred MIME type
  - `idempotency_key` string — Deduplicates sends for 24h.
  - `scheduled_at` string, date-time
  - `template_id` string
  - `variables` object

## Response `200`

Email accepted

- SendEmailResponse
  - `id` string, required — Email public ID (starts with `em_`)

## Other responses

- `400` — Request body or query params failed validation
- `401` — Missing or invalid API key
- `402` — Plan quota exhausted (monthly send cap / domain cap / mailbox cap)
- `429` — Too many requests — back off and retry

---

[API](https://skmtc.dev/poststack/apis/poststack-api.md) · [All operations](https://skmtc.dev/poststack/apis/poststack-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/poststack/poststack-api/revisions/0f5bfcfae749/schema)