---
title: "Changes to Create mailing labels"
method: POST
path: "/v1/mailing/mail_labels"
---

# Changes to Create mailing labels

`POST /v1/mailing/mail_labels`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 24 revisions.

- **2026-10-22** `e998dffc42be`: 6 warning, 5 info
- **2026-10-09** `020f57d6f5b8`: 89 breaking, 93 warning, 252 info
- **2026-09-24** `ebaf10248333`: 2 breaking
- **2026-09-10** `1b7465aea2da`: 2 warning
- **2026-09-09** `a53b77a09f4a`: 4 info
- **2026-09-06** `3fdd35fbad5c`: 2 warning
- **2026-09-04** `0ea4426bd2c9`: 3 info
- **2026-09-03** `af7218990159`: 3 info
- **2026-09-02** `45d27f8700ae`: 3 info
- **2026-08-19** `3a3a81a22d2f`: 4 warning, 1 info
- **2026-08-15** `f3a66d204565`: 12 warning

## Changes

- **2026-10-22** `e998dffc42be`: 6 warning, 5 info
  - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `400`
  - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `500`
  - added the new `multiple_sales_orders` enum value to the `errors/items/error_code` response property for the response status `400`
  - added the new `multiple_sales_orders` enum value to the `errors/items/error_code` response property for the response status `500`
  - added the new `sales_order_link_required` enum value to the `errors/items/error_code` response property for the response status `400`
  - added the new `sales_order_link_required` enum value to the `errors/items/error_code` response property for the response status `500`
  - added the new optional request property `shipments/items/items/items/item_id`
  - added the optional property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/item_id` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/items/items/item_id` to the response with the `200` status
  - added `subschema #2: shipment_sales_order_fields` to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/` response property `allOf` list for the response status `200`
  - added `subschema #2: shipment_sales_order_fields` to the `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/` response property `allOf` list for the response status `200`
- **2026-10-09** `020f57d6f5b8`: 89 breaking, 93 warning, 252 info
  - added the new required request property `shipments/items/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/address_line1`
  - added the new required request property `shipments/items/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/city_locality`
  - added the new required request property `shipments/items/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/country_code`
  - added the new required request property `shipments/items/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/name`
  - added the new required request property `shipments/items/customs/allOf[subschema #1: international_shipment_options]/importer_of_record/postal_code`
  - added the new required request property `shipments/items/packages/items/weight`
  - added the new required request property `shipments/items/tax_identifiers/items/identifier_type`
  - added the new required request property `shipments/items/tax_identifiers/items/issuing_authority`
  - added the new required request property `shipments/items/tax_identifiers/items/taxable_entity_type`
  - added the new required request property `shipments/items/tax_identifiers/items/value`
  - request property `shipments/items/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` was restricted to a list of enum values
  - request property `shipments/items/advanced_options/allOf[subschema #1: advanced_shipment_options]/dry_ice_weight/allOf[subschema #1: weight]/unit` was restricted to a list of enum values
  - request property `shipments/items/customs/allOf[subschema #1: international_shipment_options]/customs_items/items/weight/allOf[subschema #1: weight]/unit` was restricted to a list of enum values
  - request property `shipments/items/order_source_code` was restricted to a list of enum values
  - the `shipments/items/return_to/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property's minLength was increased from `0` to `1`
  - the `shipments/items/ship_from/allOf[subschema #1: shipping_address_from]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property's minLength was increased from `0` to `1`
  - the `shipments/items/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property's minLength was increased from `0` to `1`
  - the `shipments/items/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_amount/currency` request property type changed from no type to `string`
  - the `shipments/items/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` request property type changed from no type to `string`
  - the `shipments/items/advanced_options/allOf[subschema #1: advanced_shipment_options]/dry_ice_weight/allOf[subschema #1: weight]/unit` request property type changed from no type to `string`
  - the `shipments/items/customs/allOf[subschema #1: international_shipment_options]/customs_items/items/weight/allOf[subschema #1: weight]/unit` request property type changed from no type to `string`
  - the `shipments/items/customs/allOf[subschema #1: international_shipment_options]/importer_of_record` request property type changed from no type to `object`
  - the `shipments/items/customs/allOf[subschema #1: international_shipment_options]/invoice_additional_details` request property type changed from no type to `object`
  - the `shipments/items/items/items/` request property type changed from no type to `object`
  - the `shipments/items/order_source_code` request property type changed from no type to `string`
  - the `shipments/items/packages/items/` request property type changed from no type to `object`
  - the `shipments/items/return_to/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property type changed from no type to `string`
  - the `shipments/items/ship_from/allOf[subschema #1: shipping_address_from]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property type changed from no type to `string`
  - the `shipments/items/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` request property type changed from no type to `string`
  - the `shipments/items/tax_identifiers/items/` request property type changed from no type to `object`
  - the `allOf[subschema #1: label]/insurance_cost/allOf[subschema #1: monetary_value]/currency` response's property type changed from no type to `string` for status `200`
  - the `allOf[subschema #1: label]/packages/items/allOf[subschema #1: label_package]/insured_value/allOf[subschema #1: monetary_value]/currency` response's property type changed from no type to `string` for status `200`
  - the `allOf[subschema #1: label]/packages/items/allOf[subschema #1: label_package]/label_messages` response's property type changed from no type to `object` for status `200`
  - the `allOf[subschema #1: label]/packages/items/allOf[subschema #1: label_package]/weight/allOf[subschema #1: weight]/unit` response's property type changed from no type to `string` for status `200`
  - the `allOf[subschema #1: label]/rate_details/items/` response's property type changed from no type to `object` for status `200`
  - the `allOf[subschema #1: label]/refund_details/allOf[subschema #1: refund_details]/amount_approved/allOf[subschema #1: monetary_value]/currency` response's property type changed from no type to `string` for status `200`
  - the `allOf[subschema #1: label]/refund_details/allOf[subschema #1: refund_details]/amount_credited/allOf[subschema #1: monetary_value]/currency` response's property type changed from no type to `string` for status `200`
  - the `allOf[subschema #1: label]/refund_details/allOf[subschema #1: refund_details]/amount_paid/allOf[subschema #1: monetary_value]/currency` response's property type changed from no type to `string` for status `200`
  - the `allOf[subschema #1: label]/refund_details/allOf[subschema #1: refund_details]/amount_requested/allOf[subschema #1: monetary_value]/currency` response's property type changed from no type to `string` for status `200`
  - the `allOf[subschema #1: label]/requested_comparison_amount/allOf[subschema #1: monetary_value]/currency` response's property type changed from no type to `string` for status `200`
  - …394 more
- **2026-09-24** `ebaf10248333`: 2 breaking
  - the response property `allOf[subschema #1: label]/rate_details/items/allOf[subschema #1: rate_detail]/carrier_description` became nullable for the status `200`
  - the response property `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/rate_details/items/allOf[subschema #1: rate_detail]/carrier_description` became nullable for the status `200`
- **2026-09-10** `1b7465aea2da`: 2 warning
  - removed the optional property `allOf[subschema #1: label]/delivery_prediction` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/delivery_prediction` from the response with the `200` status
- **2026-09-09** `a53b77a09f4a`: 4 info
  - added the optional property `allOf[subschema #1: label]/delivery_prediction` to the response with the `200` status
  - added the optional property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/batch_ids` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/delivery_prediction` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/batch_ids` to the response with the `200` status
- **2026-09-06** `3fdd35fbad5c`: 2 warning
  - added the new `freight_provider_already_connected` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `freight_provider_already_connected` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
- **2026-09-04** `0ea4426bd2c9`: 3 info
  - added the new optional request property `shipments/items/advanced_options/allOf[subschema #1: advanced_shipment_options]/suppress_carrier_generated_documents`
  - added the optional property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/suppress_carrier_generated_documents` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/suppress_carrier_generated_documents` to the response with the `200` status
- **2026-09-03** `af7218990159`: 3 info
  - added the new optional request property `shipments/items/advanced_options/allOf[subschema #1: advanced_shipment_options]/transparency_codes`
  - added the optional property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/transparency_codes` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/transparency_codes` to the response with the `200` status
- **2026-09-02** `45d27f8700ae`: 3 info
  - added the new optional request property `shipments/items/packages/items/allOf[subschema #1: package]/products/items/cpsc_disclaim`
  - added the optional property `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/packages/items/allOf[subschema #1: package]/products/items/cpsc_disclaim` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/packages/items/allOf[subschema #1: package]/products/items/cpsc_disclaim` to the response with the `200` status
- **2026-08-19** `3a3a81a22d2f`: 4 warning, 1 info
  - added the new `adult_signature_restricted_delivery` enum value to the `allOf[subschema #1: label]/confirmation/allOf[subschema #1: delivery_confirmation]/` response property for the response status `200`
  - added the new `adult_signature_restricted_delivery` enum value to the `allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/confirmation/allOf[subschema #1: delivery_confirmation]/` response property for the response status `200`
  - added the new `adult_signature_restricted_delivery` enum value to the `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/confirmation/allOf[subschema #1: delivery_confirmation]/` response property for the response status `200`
  - added the new `adult_signature_restricted_delivery` enum value to the `allOf[subschema #2]/associated_labels/items/allOf[subschema #1: label]/shipment/allOf[subschema #1: shipment]/allOf[subschema #1: partial_shipment]/confirmation/allOf[subschema #1: delivery_confirmation]/` response property for the response status `200`
  - added the new `adult_signature_restricted_delivery` enum value to the request property `shipments/items/confirmation/allOf[subschema #1: delivery_confirmation]/`
- **2026-08-15** `f3a66d204565`: 12 warning
  - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `freight_connection_inactive` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `freight_provider_id_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `freight_provider_id_required` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `freight_shipment_not_batchable` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `freight_shipment_not_batchable` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `freight_shipment_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `freight_shipment_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `freight_tracking_not_available` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `freight_tracking_not_available` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`
  - added the new `freight_tracking_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `400`
  - added the new `freight_tracking_not_found` enum value to the `errors/items/allOf[subschema #1: error]/error_code/allOf[subschema #1: error_code]/` response property for the response status `500`

---

[Operation](https://skmtc.dev/shipstation/apis/shipengine-api/docs/v1/mailing/mail_labels/post.md) - [API](https://skmtc.dev/shipstation/apis/shipengine-api.md) - [Page](https://skmtc.dev/shipstation/apis/shipengine-api/changes/v1/mailing/mail_labels/post)