---
title: "POST /v1/emails"
method: POST
path: "/v1/emails"
---

# POST /v1/emails

`POST /v1/emails`

## Request body

- object
  - `to` union, required
    - string
    - string[]
  - `from` string, required
  - `subject` string, required
  - `replyTo` union
    - string
    - string[]
  - `cc` union
    - string
    - string[]
  - `bcc` union
    - string
    - string[]
  - `text` string
  - `html` string
  - `attachments` object[]
    - `filename` string, required
    - `content` string, required

## Response `200`

Retrieve the user

- object
  - `emailId` string

## Changes

- **2024-06-25** `c61ce1948029` — 4 breaking, 5 info
  - removed `subschema #1, subschema #2` from the `bcc` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `cc` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `replyTo` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `to` request property `anyOf` list
  - …5 more
- **2024-06-23** `8a412798ffaa` — 4 info
  - added the new optional request property `bcc`
  - added the new optional request property `cc`
  - request property `replyTo` list-of-types was widened by adding types `array` to media type `application/json`
  - request property `to` list-of-types was widened by adding types `array` to media type `application/json`
- **2024-05-21** `ad91eadfd8ee` — 6 breaking, 8 warning, 5 info
  - the request property `html` became not nullable
  - the request property `text` became not nullable
  - the request property `subject` became required
  - request property `replyTo` list-of-types was narrowed by removing types `array` from media type `application/json`
  - …15 more

[Change history](https://skmtc.dev/usesend/apis/usesend-api/changes/v1/emails/post.md)

---

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