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

# Changes to Create a shipment draft

`POST /shipment_drafts`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 11 revisions.

- **2026-09-11** `597a3e53ac0d` — 2 info
- **2026-08-21** `3b9f91693dec` — 6 breaking, 6 info
- **2026-08-21** `ad86900cf9c2` — 3 breaking, 12 warning, 1 info

## Changes

- **2026-09-11** `597a3e53ac0d` — 2 info
  - added the new optional request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/parties/items/state`
  - added the optional property `allOf[#/components/schemas/ShipmentDraft]/parties/items/state` to the response with the `200` status
- **2026-08-21** `3b9f91693dec` — 6 breaking, 6 info
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parcels/items/allOf[#/components/schemas/ShipmentDraftParcel]/declared_value/amount` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parcels/items/allOf[#/components/schemas/ShipmentDraftParcel]/declared_value/currency_code` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parties/items/address2` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parties/items/attention` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parties/items/email` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/ShipmentDraft]/parties/items/phone` became nullable for the status `200`
  - the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/parcels/items/allOf[#/components/schemas/ShipmentDraftParcel]/declared_value/amount` became nullable
  - the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/parcels/items/allOf[#/components/schemas/ShipmentDraftParcel]/declared_value/currency_code` became nullable
  - the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/parties/items/address2` became nullable
  - the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/parties/items/attention` became nullable
  - the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/parties/items/email` became nullable
  - the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/parties/items/phone` became nullable
- **2026-08-21** `ad86900cf9c2` — 3 breaking, 12 warning, 1 info
  - added `#/components/schemas/ShipmentDraftCustoms` to the `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/customs` request property `allOf` list
  - the `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/customs` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/ShipmentDraft]/customs` response's property type changed from `object` to no type for status `200`
  - removed the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/customs/attributes`
  - removed the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/customs/currency_code`
  - removed the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/customs/export_reason`
  - removed the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/customs/freight_cost`
  - removed the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/customs/goods`
  - removed the request property `allOf[#/components/schemas/ShipmentDraftRequest]/allOf[#/components/schemas/ShipmentDraft]/customs/insurance_cost`
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/attributes` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/currency_code` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/export_reason` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/freight_cost` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/goods` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/ShipmentDraft]/customs/insurance_cost` from the response with the `200` status
  - added `#/components/schemas/ShipmentDraftCustoms` to the `allOf[#/components/schemas/ShipmentDraft]/customs` response property `allOf` list for the response status `200`

---

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