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

# Changes to Create a shipment

`POST /shipments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 17 revisions.

- **2026-10-29** `66ee3fc2c699`: 1 info
- **2026-09-11** `597a3e53ac0d`: 2 info
- **2026-08-21** `3b9f91693dec`: 47 breaking, 6 info
- **2026-08-21** `ad86900cf9c2`: 1 breaking, 2 warning, 1 info
- **2026-08-19** `cb0208047b4e`: 2 breaking
- **2026-08-11** `f3622e6b908a`: 1 info

## Changes

- **2026-10-29** `66ee3fc2c699`: 1 info
  - added the optional property `allOf[#/components/schemas/Shipment]/documents` to the response with the `200` status
- **2026-09-11** `597a3e53ac0d`: 2 info
  - added the new optional request property `parties/items/state`
  - added the optional property `allOf[#/components/schemas/Shipment]/parties/items/state` to the response with the `200` status
- **2026-08-21** `3b9f91693dec`: 47 breaking, 6 info
  - the `origin_shipment_id` request property type changed from `string` to `integer`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/address1` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/address2` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/attention` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/bill_to_custom` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/city` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/country_code` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/customer_number` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/email` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/mobile` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/name` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/telephone` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/vat_id` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/bill_to/zipcode` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/delivery_details` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/parcels/items/declared_value/allOf[#/components/schemas/DeclaredValue]/amount` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/parcels/items/declared_value/allOf[#/components/schemas/DeclaredValue]/currency_code` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/parcels/items/pkg_no` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/parcels/items/pkg_nos` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/parties/items/address2` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/parties/items/attention` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/parties/items/email` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/parties/items/phone` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/address1` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/address2` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/attention` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/city` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/country_code` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/date` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/from_time` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/instruction` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/name` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/pickup_custom` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/telephone` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/to_time` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pick_up/zipcode` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pickup_details` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/pkg_no` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/receiver/email` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/Shipment]/sender/email` became nullable for the status `200`
  - …13 more
- **2026-08-21** `ad86900cf9c2`: 1 breaking, 2 warning, 1 info
  - the `allOf[#/components/schemas/Shipment]/parcels/items/declared_value` response's property type changed from `object` to no type for status `200`
  - removed the optional property `allOf[#/components/schemas/Shipment]/parcels/items/declared_value/amount` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/Shipment]/parcels/items/declared_value/currency_code` from the response with the `200` status
  - added `#/components/schemas/DeclaredValue` to the `allOf[#/components/schemas/Shipment]/parcels/items/declared_value` response property `allOf` list for the response status `200`
- **2026-08-19** `cb0208047b4e`: 2 breaking
  - the request property `documents/items/document_type` became required
  - the request property `documents/items/signed_id` became required
- **2026-08-11** `f3622e6b908a`: 1 info
  - added the new optional request property `label_dpi`

---

[Operation](https://skmtc.dev/shipmondo/apis/shipmondo-api/docs/shipments/post.md) - [API](https://skmtc.dev/shipmondo/apis/shipmondo-api.md) - [Page](https://skmtc.dev/shipmondo/apis/shipmondo-api/changes/shipments/post)