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

# Changes to POST /v1/emails

`POST /v1/emails`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 27 revisions.

- **2025-11-17** `d5dbb8522d58`: 1 info
- **2025-09-28** `b78e8de12151`: 1 info
- **2025-09-26** `f3f4be68abf8`: 3 breaking, 3 info
- **2025-06-01** `80d7f1c84475`: 1 breaking, 2 info
- **2025-05-25** `df13b10684f7`: 1 info
- **2025-04-19** `078f534faefa`: 10 breaking, 6 info
- **2025-03-08** `95336f26e872`: 3 info
- **2024-08-21** `090b3a3f3e99`: 1 info
- **2024-06-25** `c61ce1948029`: 4 breaking, 5 info
- **2024-06-23** `8a412798ffaa`: 4 info
- **2024-05-21** `ad91eadfd8ee`: 6 breaking, 8 warning, 5 info

## Changes

- **2025-11-17** `d5dbb8522d58`: 1 info
  - added the new optional `header` request parameter `Idempotency-Key`
- **2025-09-28** `b78e8de12151`: 1 info
  - added the new optional request property `headers`
- **2025-09-26** `f3f4be68abf8`: 3 breaking, 3 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
  - added `subschema #1, subschema #2` to the `bcc` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `cc` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `replyTo` request property `anyOf` list
- **2025-06-01** `80d7f1c84475`: 1 breaking, 2 info
  - removed `subschema #1, subschema #2` from the `to` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `to` request property `anyOf` list
  - the `from` request property format was generalized from `email` to no format
- **2025-05-25** `df13b10684f7`: 1 info
  - added the new optional request property `inReplyToId`
- **2025-04-19** `078f534faefa`: 10 breaking, 6 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
  - the `attachments/items/content` request property's minLength was increased from `0` to `1`
  - the `attachments/items/filename` request property's minLength was increased from `0` to `1`
  - the `html` request property's minLength was increased from `0` to `1`
  - the `subject` request property's minLength was increased from `0` to `1`
  - the `text` request property's minLength was increased from `0` to `1`
  - the `from` request property format changed from no format to `email`
  - added `subschema #1, subschema #2` to the `bcc` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `cc` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `replyTo` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `to` request property `anyOf` list
  - the request property `html` became nullable
  - the request property `text` became nullable
- **2025-03-08** `95336f26e872`: 3 info
  - added the new optional request property `templateId`
  - added the new optional request property `variables`
  - the request property `subject` became optional
- **2024-08-21** `090b3a3f3e99`: 1 info
  - added the new optional request property `scheduledAt`
- **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
  - added `subschema #1, subschema #2` to the `bcc` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `cc` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `replyTo` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `to` request property `anyOf` list
  - the `from` request property format was generalized from `email` to no format
- **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`
  - request property `to` list-of-types was narrowed by removing types `array` from media type `application/json`
  - the `from` request property format changed from no format to `email`
  - deleted the `header` request parameter `Idempotency-Key`
  - removed the request property `bcc`
  - removed the request property `cc`
  - removed the request property `headers`
  - removed the request property `inReplyToId`
  - removed the request property `scheduledAt`
  - removed the request property `templateId`
  - removed the request property `variables`
  - the `attachments/items/content` request property's minLength was decreased from `1` to `0`
  - the `attachments/items/filename` request property's minLength was decreased from `1` to `0`
  - the `html` request property's minLength was decreased from `1` to `0`
  - the `subject` request property's minLength was decreased from `1` to `0`
  - the `text` request property's minLength was decreased from `1` to `0`

---

[Operation](https://skmtc.dev/usesend/apis/usesend-api/docs/v1/emails/post.md) - [API](https://skmtc.dev/usesend/apis/usesend-api.md) - [Page](https://skmtc.dev/usesend/apis/usesend-api/changes/v1/emails/post)
