---
title: "Changes to Create Letter Create Letter"
method: POST
path: "/print-mail/v1/letters"
---

# Changes to Create Letter Create Letter

`POST /print-mail/v1/letters`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 7 revisions.

- **2026-06-12** `537d2bbc624a` — 26 breaking, 18 warning, 14 info
- **2026-06-12** `54cf11f8a76f` — 14 info
- **2026-05-21** `afd5935c2b2c` — 2 breaking, 18 info
- **2026-05-01** `c8fedcbd705e` — 4 warning, 2 info

## Changes

- **2026-06-12** `537d2bbc624a` — 26 breaking, 18 warning, 14 info
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/LetterCreateWithHTML]/attachedPDF/allOf[#/components/schemas/AttachedPDF]/file` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/LetterCreateWithHTML]/plasticCard/allOf[#/components/schemas/PlasticCard]/doubleSided/allOf[#/components/schemas/PlasticCardDoubleSided]/pdf` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/LetterCreateWithHTML]/plasticCard/allOf[#/components/schemas/PlasticCard]/singleSided/allOf[#/components/schemas/PlasticCardSingleSided]/pdf` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/LetterCreateWithPDF]/attachedPDF/allOf[#/components/schemas/AttachedPDF]/file` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/LetterCreateWithPDF]/pdf` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/LetterCreateWithPDF]/plasticCard/allOf[#/components/schemas/PlasticCard]/doubleSided/allOf[#/components/schemas/PlasticCardDoubleSided]/pdf` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/LetterCreateWithPDF]/plasticCard/allOf[#/components/schemas/PlasticCard]/singleSided/allOf[#/components/schemas/PlasticCardSingleSided]/pdf` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/LetterCreateWithTemplate]/attachedPDF/allOf[#/components/schemas/AttachedPDF]/file` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/LetterCreateWithTemplate]/plasticCard/allOf[#/components/schemas/PlasticCard]/doubleSided/allOf[#/components/schemas/PlasticCardDoubleSided]/pdf` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `anyOf[#/components/schemas/LetterCreateWithTemplate]/plasticCard/allOf[#/components/schemas/PlasticCard]/singleSided/allOf[#/components/schemas/PlasticCardSingleSided]/pdf` request property `anyOf` list
  - the response's body type/format changed from `object`/`` to ``/`` for status `201`
  - removed the required property `addressPlacement` from the response with the `201` status
  - removed the required property `color` from the response with the `201` status
  - removed the required property `createdAt` from the response with the `201` status
  - removed the required property `doubleSided` from the response with the `201` status
  - removed the required property `envelope` from the response with the `201` status
  - removed the required property `from` from the response with the `201` status
  - removed the required property `id` from the response with the `201` status
  - removed the required property `live` from the response with the `201` status
  - removed the required property `mailingClass` from the response with the `201` status
  - removed the required property `object` from the response with the `201` status
  - removed the required property `sendDate` from the response with the `201` status
  - removed the required property `size` from the response with the `201` status
  - removed the required property `status` from the response with the `201` status
  - removed the required property `to` from the response with the `201` status
  - removed the required property `updatedAt` from the response with the `201` status
  - removed the optional property `attachedPDF` from the response with the `201` status
  - removed the optional property `cancellation` from the response with the `201` status
  - removed the optional property `description` from the response with the `201` status
  - removed the optional property `html` from the response with the `201` status
  - removed the optional property `imbDate` from the response with the `201` status
  - removed the optional property `imbStatus` from the response with the `201` status
  - removed the optional property `imbZIPCode` from the response with the `201` status
  - removed the optional property `mergeVariables` from the response with the `201` status
  - removed the optional property `metadata` from the response with the `201` status
  - removed the optional property `paper` from the response with the `201` status
  - removed the optional property `pdfWorkflowRun` from the response with the `201` status
  - removed the optional property `perforatedPage` from the response with the `201` status
  - removed the optional property `plasticCard` from the response with the `201` status
  - removed the optional property `returnEnvelope` from the response with the `201` status
  - …18 more
- **2026-06-12** `54cf11f8a76f` — 14 info
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithHTML]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithHTML]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithHTML]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithHTML]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithPDF]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithPDF]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithPDF]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithPDF]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the optional property `from/allOf[#/components/schemas/Contact]/secret` to the response with the `201` status
  - added the optional property `to/allOf[#/components/schemas/Contact]/secret` to the response with the `201` status
- **2026-05-21** `afd5935c2b2c` — 2 breaking, 18 info
  - added the new required request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/from`
  - added the new required request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/to`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithHTML]/paper`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithPDF]/paper`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/addressPlacement`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/attachedPDF`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/color`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/description`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/doubleSided`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/envelope`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/mailingClass`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/mergeVariables`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/metadata`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/paper`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/perforatedPage`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/plasticCard`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/returnEnvelope`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/sendDate`
  - added the new optional request property `anyOf[#/components/schemas/LetterCreateWithTemplate]/size`
  - added the optional property `paper` to the response with the `201` status
- **2026-05-01** `c8fedcbd705e` — 4 warning, 2 info
  - added the new `internal_server_error` enum value to the `error/type` response property for the response status `500`
  - added the new `not_found_error` enum value to the `error/type` response property for the response status `404`
  - added the new `rate_limit_exceeded_error` enum value to the `error/type` response property for the response status `429`
  - added the new `validation_error` enum value to the `error/type` response property for the response status `400`
  - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `401`
  - removed `subschema #1, subschema #2` from the response body `anyOf` list for the response status `401`

---

[Operation](https://skmtc.dev/postgrid/apis/postgrid-address-verification-api/docs/print-mail/v1/letters/post.md) · [API](https://skmtc.dev/postgrid/apis/postgrid-address-verification-api.md) · [Page](https://skmtc.dev/postgrid/apis/postgrid-address-verification-api/changes/print-mail/v1/letters/post)