Self Mailers

Create Self Mailer Create Self Mailer

Create a self-mailer. Note that you can supply one of the following:

HTML content for the inside and outside of the self-mailer
A template ID for the inside and outside of the self-mailer
A URL for a 2 page PDF where the first page is the outside of the self-mailer and the second page is the inside Create a self-mailer via a multipart/form-data request. Accepts the same fields as the JSON create body (nested objects are bracket-encoded form fields, e.g. to[firstName]); use this content type to upload the PDF file directly.

post/print-mail/v1/self_mailers

Headers

idempotency-keystring

Request body

Response

the created SelfMailer.

Changes

Changed in 4 of the 7 revisions of this API.171329

Jun 12, 2026537d2bbc624a1494See the full diff
- ▲
  added BinaryFile to the anyOf[SelfMailerCreateWithPDFFile]/pdf request property allOf list
  request-property-all-of-added
- ▲
  the anyOf[SelfMailerCreateWithPDFFile]/pdf request property type/format changed from string/byte to /
  request-property-type-changed
- ▲
  the response's body type/format changed from object/ to / for status 201
  response-body-type-changed
- ▲
  removed the required property createdAt from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property from from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property id from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property live from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property mailingClass from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property object from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property sendDate from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property size from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property status from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property to from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property updatedAt from the response with the 201 status
  response-required-property-removed
- ●
  removed the optional property cancellation from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property description from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property imbDate from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property imbStatus from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property imbZIPCode from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property mergeVariables from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property metadata from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property trackingNumber from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property url from the response with the 201 status
  response-optional-property-removed
- ○
  api operation id SelfMailers_create removed and replaced with SelfMailers_createJSON_SelfMailers_createMultipart
  api-operation-id-removed
- ○
  added the new optional header request parameter idempotency-key
  new-optional-request-parameter
- ○
  added the media type multipart/form-data to the request body
  request-body-media-type-added
- ○
  added SelfMailer SelfMailer to the response body anyOf list for the response status 201
  response-body-any-of-added
Jun 12, 202654cf11f8a76f18See the full diff
- ○
  added the new optional request property anyOf[SelfMailerCreateWithHTML]/from/anyOf[ContactCreate]/oneOf[ContactCreateWithCompanyName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithHTML]/from/anyOf[ContactCreate]/oneOf[ContactCreateWithFirstName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithHTML]/to/anyOf[ContactCreate]/oneOf[ContactCreateWithCompanyName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithHTML]/to/anyOf[ContactCreate]/oneOf[ContactCreateWithFirstName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithPDFFile]/from/anyOf[ContactCreate]/oneOf[ContactCreateWithCompanyName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithPDFFile]/from/anyOf[ContactCreate]/oneOf[ContactCreateWithFirstName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithPDFFile]/to/anyOf[ContactCreate]/oneOf[ContactCreateWithCompanyName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithPDFFile]/to/anyOf[ContactCreate]/oneOf[ContactCreateWithFirstName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithPDFURL]/from/anyOf[ContactCreate]/oneOf[ContactCreateWithCompanyName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithPDFURL]/from/anyOf[ContactCreate]/oneOf[ContactCreateWithFirstName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithPDFURL]/to/anyOf[ContactCreate]/oneOf[ContactCreateWithCompanyName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithPDFURL]/to/anyOf[ContactCreate]/oneOf[ContactCreateWithFirstName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithTemplate]/from/anyOf[ContactCreate]/oneOf[ContactCreateWithCompanyName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithTemplate]/from/anyOf[ContactCreate]/oneOf[ContactCreateWithFirstName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithTemplate]/to/anyOf[ContactCreate]/oneOf[ContactCreateWithCompanyName]/secret
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithTemplate]/to/anyOf[ContactCreate]/oneOf[ContactCreateWithFirstName]/secret
  new-optional-request-property
- ○
  added the optional property from/allOf[Contact]/secret to the response with the 201 status
  response-optional-property-added
- ○
  added the optional property to/allOf[Contact]/secret to the response with the 201 status
  response-optional-property-added
May 21, 2026afd5935c2b2c35See the full diff
- ▲
  added the new required request property anyOf[SelfMailerCreateWithTemplate]/from
  new-required-request-property
- ▲
  added the new required request property anyOf[SelfMailerCreateWithTemplate]/size
  new-required-request-property
- ▲
  added the new required request property anyOf[SelfMailerCreateWithTemplate]/to
  new-required-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithTemplate]/description
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithTemplate]/mailingClass
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithTemplate]/mergeVariables
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithTemplate]/metadata
  new-optional-request-property
- ○
  added the new optional request property anyOf[SelfMailerCreateWithTemplate]/sendDate
  new-optional-request-property
May 1, 2026c8fedcbd705e42See the full diff
- ●
  added the new internal_server_error enum value to the error/type response property for the response status 500
  response-property-enum-value-added
- ●
  added the new not_found_error enum value to the error/type response property for the response status 404
  response-property-enum-value-added
- ●
  added the new rate_limit_exceeded_error enum value to the error/type response property for the response status 429
  response-property-enum-value-added
- ●
  added the new validation_error enum value to the error/type response property for the response status 400
  response-property-enum-value-added
- ○
  added subschema #1 subschema #2 to the response body anyOf list for the response status 401
  response-body-any-of-added
- ○
  removed subschema #1 subschema #2 from the response body anyOf list for the response status 401
  response-body-any-of-removed
This revision also has 21 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history