---
title: "Changes to Create shipments"
method: POST
path: "/v1/shipments"
---

# Changes to Create shipments

`POST /v1/shipments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 24 revisions.

- **2026-10-22** `e998dffc42be`: 6 warning, 2 info
- **2026-10-09** `020f57d6f5b8`: 22 breaking, 41 warning, 83 info
- **2026-09-09** `a53b77a09f4a`: 1 info
- **2026-09-06** `3fdd35fbad5c`: 2 warning
- **2026-09-04** `0ea4426bd2c9`: 2 info
- **2026-09-03** `af7218990159`: 2 info
- **2026-09-02** `45d27f8700ae`: 2 info
- **2026-08-19** `3a3a81a22d2f`: 1 warning, 1 info
- **2026-08-15** `f3a66d204565`: 12 warning

## Changes

- **2026-10-22** `e998dffc42be`: 6 warning, 2 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/allOf[subschema #2: partial_shipment]/items/items/item_id`
  - added the optional property `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/items/items/item_id` to the response with the `200` status
- **2026-10-09** `020f57d6f5b8`: 22 breaking, 41 warning, 83 info
  - added `#/components/schemas/validate_shipment_fields, #/components/schemas/partial_shipment` to the `shipments/items/` request property `allOf` list
  - the `shipments/items/` request property type changed from no type to `object`
  - the `errors/items/` response's property type changed from no type to `object` for status `400`
  - the `errors/items/` response's property type changed from no type to `object` for status `500`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_amount/currency` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/dry_ice_weight/allOf[subschema #1: weight]/unit` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/batch_ids/items/` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/customs_items/items/weight/allOf[subschema #1: weight]/unit` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/importer_of_record` response's property type changed from no type to `object` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/invoice_additional_details` response's property type changed from no type to `object` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/items/items/` response's property type changed from no type to `object` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/packages/items/` response's property type changed from no type to `object` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/return_to/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/ship_from/allOf[subschema #1: shipping_address]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/ship_to/allOf[subschema #1: shipping_address_to]/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/tags/items/` response's property type changed from no type to `object` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/tax_identifiers/items/` response's property type changed from no type to `object` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/total_weight/allOf[subschema #1: weight]/unit` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #2: create_shipment_response_body_fields]/address_validation/allOf[subschema #1: address_validation_result]/matched_address/allOf[subschema #1: address]/allOf[subschema #1: partial_address]/postal_code` response's property type changed from no type to `string` for status `200`
  - the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #2: create_shipment_response_body_fields]/address_validation/allOf[subschema #1: address_validation_result]/status` response's property type changed from no type to `string` for status `200`
  - removed `#/components/schemas/address_validating_shipment` from the `shipments/items/` request property `allOf` list
  - added the new `amazon_ca` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200`
  - added the new `amazon_us` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200`
  - added the new `any` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200`
  - added the new `brightpearl` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200`
  - added the new `cash` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200`
  - added the new `cash_equivalent` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/collect_on_delivery/payment_type` response property for the response status `200`
  - added the new `channel_advisor` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200`
  - added the new `cratejoy` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200`
  - added the new `ebay` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200`
  - added the new `error` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #2: create_shipment_response_body_fields]/address_validation/allOf[subschema #1: address_validation_result]/status` response property for the response status `200`
  - added the new `etsy` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200`
  - added the new `gram` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/dry_ice_weight/allOf[subschema #1: weight]/unit` response property for the response status `200`
  - added the new `gram` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/customs/allOf[subschema #1: international_shipment_options]/customs_items/items/weight/allOf[subschema #1: weight]/unit` response property for the response status `200`
  - added the new `gram` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/total_weight/allOf[subschema #1: weight]/unit` response property for the response status `200`
  - added the new `groupon_goods` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200`
  - added the new `jane` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/order_source_code` response property for the response status `200`
  - added the new `kilogram` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_shipment]/allOf[subschema #1: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/dry_ice_weight/allOf[subschema #1: weight]/unit` response property for the response status `200`
  - …106 more
- **2026-09-09** `a53b77a09f4a`: 1 info
  - added the optional property `shipments/items/allOf[subschema #1: create_and_validate_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`: 2 info
  - added the new optional request property `shipments/items/allOf[subschema #1: address_validating_shipment]/allOf[subschema #2: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/suppress_carrier_generated_documents`
  - added the optional property `shipments/items/allOf[subschema #1: create_and_validate_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`: 2 info
  - added the new optional request property `shipments/items/allOf[subschema #1: address_validating_shipment]/allOf[subschema #2: partial_shipment]/advanced_options/allOf[subschema #1: advanced_shipment_options]/transparency_codes`
  - added the optional property `shipments/items/allOf[subschema #1: create_and_validate_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`: 2 info
  - added the new optional request property `shipments/items/allOf[subschema #1: address_validating_shipment]/allOf[subschema #2: partial_shipment]/packages/items/allOf[subschema #1: package]/products/items/cpsc_disclaim`
  - added the optional property `shipments/items/allOf[subschema #1: create_and_validate_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`: 1 warning, 1 info
  - added the new `adult_signature_restricted_delivery` enum value to the `shipments/items/allOf[subschema #1: create_and_validate_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/allOf[subschema #1: address_validating_shipment]/allOf[subschema #2: partial_shipment]/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/shipments/post.md) - [API](https://skmtc.dev/shipstation/apis/shipengine-api.md) - [Page](https://skmtc.dev/shipstation/apis/shipengine-api/changes/v1/shipments/post)