---
title: "POST /v1/email"
method: POST
path: "/v1/email"
tags: ["emails"]
---

# POST /v1/email

`POST /v1/email`

Send emails

## Request body

- object — Fields for an email to be sent
  - `subject` string — The subject line of the email
  - `from` union
    - string
    - object — An email address and name
      - `name` string
      - `email` string, required
  - `headers` object — A set of headers to include the email that you send
  - `to` union — A single email or list of emails for one of the address fields
    - string
    - object — An email address and name
      - `name` string
      - `email` string, required
    - union[]
      - union
        - string
        - object — An email address and name
          - `name` string
          - `email` string, required
  - `cc` union — A single email or list of emails for one of the address fields
    - string
    - object — An email address and name
      - `name` string
      - `email` string, required
    - union[]
      - union
        - string
        - object — An email address and name
          - `name` string
          - `email` string, required
  - `bcc` union — A single email or list of emails for one of the address fields
    - string
    - object — An email address and name
      - `name` string
      - `email` string, required
    - union[]
      - union
        - string
        - object — An email address and name
          - `name` string
          - `email` string, required
  - `text` string — Text content of the email, for email clients that may not support HTML
  - `html` string — HTML content of the email. Can be specified alongside text
  - `attachments` object[] — A list of attachments to add to the email
    - `content` string, required
    - `filename` string, required
    - `type` string
    - `disposition` string
    - `contentId` string
  - `replyToList` union — A reply-to list of email addresses
    - object — An email address and name
      - `name` string
      - `email` string, required
    - object[]
      - `name` string
      - `email` string, required

## Response `202`

Email accepted to be sent

- object — Email accepted to be sent
  - `message` string, required

## Other responses

- `500` — Default Response

## Changes

- **2026-05-14** `eee85d2eafce` — 25 warning
  - the `bcc/anyOf[subschema #1: EmailData]/anyOf[subschema #1]/` request property's maxLength was set to `320`
  - the `bcc/anyOf[subschema #1: EmailData]/anyOf[subschema #2: EmailNameAndAddress]/email` request property's maxLength was set to `320`
  - the `bcc/anyOf[subschema #1: EmailData]/anyOf[subschema #2: EmailNameAndAddress]/name` request property's maxLength was set to `256`
  - the `bcc/anyOf[subschema #2: EmailDataList]/items/anyOf[subschema #1]/` request property's maxLength was set to `320`
  - …21 more
- **2026-04-20** `8f22304950dd` — 1 breaking
  - request body became required
- **2026-01-15** `788eacc57f25` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `202`
- **2025-11-18** `4596d0810d3d` — 1 breaking
  - the `html` request property's minLength was increased from `0` to `1`

[Change history](https://skmtc.dev/val-town/apis/val-town-api/changes/v1/email/post.md)

---

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