---
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

---

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