---
title: "Changes to Create Postcard Create Postcard"
method: POST
path: "/print-mail/v1/postcards"
---

# Changes to Create Postcard Create Postcard

`POST /print-mail/v1/postcards`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 7 revisions.

- **2026-06-12** `537d2bbc624a` — 13 breaking, 11 warning, 4 info
- **2026-06-12** `54cf11f8a76f` — 18 info
- **2026-05-21** `afd5935c2b2c` — 5 breaking, 3 warning, 13 info
- **2026-05-01** `c8fedcbd705e` — 4 warning, 6 info

## Changes

- **2026-06-12** `537d2bbc624a` — 13 breaking, 11 warning, 4 info
  - added `#/components/schemas/BinaryFile` to the `anyOf[#/components/schemas/PostcardCreateWithPDFFile]/pdf` request property `allOf` list
  - the `anyOf[#/components/schemas/PostcardCreateWithPDFFile]/pdf` request property type/format changed from `string`/`byte` to ``/``
  - the response's body type/format changed from `object`/`` to ``/`` for status `201`
  - removed the required property `createdAt` 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 `cancellation` from the response with the `201` status
  - removed the optional property `description` from the response with the `201` status
  - removed the optional property `from` 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 `trackingNumber` from the response with the `201` status
  - removed the optional property `url` from the response with the `201` status
  - api operation id `Postcards_create` removed and replaced with `Postcards_createJSON_Postcards_createMultipart`
  - added the new optional `header` request parameter `idempotency-key`
  - added the media type `multipart/form-data` to the request body
  - added `#/components/schemas/Postcard, #/components/schemas/Postcard` to the response body `anyOf` list for the response status `201`
- **2026-06-12** `54cf11f8a76f` — 18 info
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithHTML]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithHTML]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithHTML]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithHTML]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithPDFFile]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithPDFFile]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithPDFFile]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithPDFFile]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithPDFURL]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithPDFURL]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithPDFURL]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithPDFURL]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/from/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithFirstName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/to/anyOf[#/components/schemas/ContactCreate]/oneOf[#/components/schemas/ContactCreateWithCompanyName]/secret`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/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` — 5 breaking, 3 warning, 13 info
  - added the new required request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/size`
  - added the new required request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/to`
  - added `#/components/schemas/PostcardPremiumPaperID` to the `anyOf[#/components/schemas/PostcardCreateWithHTML]/paper` request property `allOf` list
  - added `#/components/schemas/PostcardPremiumPaperID` to the `anyOf[#/components/schemas/PostcardCreateWithPDFFile]/paper` request property `allOf` list
  - added `#/components/schemas/PostcardPremiumPaperID` to the `anyOf[#/components/schemas/PostcardCreateWithPDFURL]/paper` request property `allOf` list
  - removed `#/components/schemas/PremiumPaperID` from the `anyOf[#/components/schemas/PostcardCreateWithHTML]/paper` request property `allOf` list
  - removed `#/components/schemas/PremiumPaperID` from the `anyOf[#/components/schemas/PostcardCreateWithPDFFile]/paper` request property `allOf` list
  - removed `#/components/schemas/PremiumPaperID` from the `anyOf[#/components/schemas/PostcardCreateWithPDFURL]/paper` request property `allOf` list
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/description`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/from`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/mailingClass`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/mergeVariables`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/metadata`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/paper`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithTemplate]/sendDate`
  - the `paper` request property default value `standard` was removed
  - the `paper` request property default value `standard` was removed
  - the `paper` request property default value `standard` was removed
  - added `#/components/schemas/PostcardPremiumPaperID` to the `paper` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/PremiumPaperID` from the `paper` response property `allOf` list for the response status `201`
  - the `paper` response's property default value `standard` was removed for the status `201`
- **2026-05-01** `c8fedcbd705e` — 4 warning, 6 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 the new optional request property `anyOf[#/components/schemas/PostcardCreateWithHTML]/paper`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithPDFFile]/paper`
  - added the new optional request property `anyOf[#/components/schemas/PostcardCreateWithPDFURL]/paper`
  - 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`
  - added the optional property `paper` to the response with the `201` status

---

[Operation](https://skmtc.dev/postgrid/apis/postgrid-address-verification-api/docs/print-mail/v1/postcards/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/postcards/post)