---
title: "Changes to Create Return"
method: POST
path: "/wms/returns"
---

# Changes to Create Return

`POST /wms/returns`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 4 revisions.

- **2026-11-03** `f9f948f2a7b3`: 11 breaking, 7 info

## Changes

- **2026-11-03** `f9f948f2a7b3`: 11 breaking, 7 info
  - removed `#/components/schemas/CreateReturnSchema--Base__Schema--` from the request body `oneOf` list
  - added `subschema #1` to the `oneOf[subschema #7: Deposco -> subschema #9: Deposco]/line_items/items/` request property `allOf` list
  - removed the enum value `exchange` of the request property `oneOf[subschema #5: J&J Global Fulfillment (Control Port) -> subschema #7: J&J Global Fulfillment (Control Port)]/line_items/items/desired_outcome`
  - removed the enum value `other` of the request property `oneOf[subschema #5: J&J Global Fulfillment (Control Port) -> subschema #7: J&J Global Fulfillment (Control Port)]/line_items/items/desired_outcome`
  - removed the enum value `refund` of the request property `oneOf[subschema #5: J&J Global Fulfillment (Control Port) -> subschema #7: J&J Global Fulfillment (Control Port)]/line_items/items/desired_outcome`
  - removed the enum value `replacement` of the request property `oneOf[subschema #5: J&J Global Fulfillment (Control Port) -> subschema #7: J&J Global Fulfillment (Control Port)]/line_items/items/desired_outcome`
  - added the pattern `^[0-9]+$` to the request property `oneOf[subschema #12: Infoplus -> subschema #15: Infoplus]/warehouse_id`
  - added the pattern `^[0-9]+$` to the request property `oneOf[subschema #21: Ongoing WMS -> subschema #27: Ongoing WMS]/warehouse_id`
  - added the pattern `^[0-9]+$` to the request property `oneOf[subschema #29: ShipStream -> subschema #36: ShipStream]/carrier_tracking_number`
  - added the pattern `^[0-9]+$` to the request property `oneOf[subschema #29: ShipStream -> subschema #36: ShipStream]/warehouse_id`
  - added the pattern `^[0-9]+$` to the request property `oneOf[subschema #5: J&J Global Fulfillment (Control Port) -> subschema #7: J&J Global Fulfillment (Control Port)]/order_id`
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional request property `oneOf[subschema #7: Deposco -> subschema #9: Deposco]/custom_attribute_1`
  - added the new optional request property `oneOf[subschema #7: Deposco -> subschema #9: Deposco]/line_items/items/custom_attribute_1`
  - added the new optional request property `oneOf[subschema #7: Deposco -> subschema #9: Deposco]/order_source`
  - added the new optional request property `oneOf[subschema #7: Deposco -> subschema #9: Deposco]/other_reference_number`
  - added `#/components/schemas/CreatewmsReturn--Bergen--, #/components/schemas/CreatewmsReturn--Boxzooka--, #/components/schemas/CreatewmsReturn--Everstox--, #/components/schemas/CreatewmsReturn--Luminous--, #/components/schemas/CreatewmsReturn--Moda__Express--, #/components/schemas/CreatewmsReturn--OIA__Global--, #/components/schemas/CreatewmsReturn--Return__Helper--, #/components/schemas/CreatewmsReturn--Shipfusion--, #/components/schemas/CreatewmsReturn--Zenfulfillment--` to the request body `oneOf` list
  - added `id, name` discriminator mapping keys to the `oneOf[subschema #12: Infoplus -> subschema #15: Infoplus]/supplier_object` request property

---

[Operation](https://skmtc.dev/trackstarhq/apis/trackstar-api/docs/wms/returns/post.md) - [API](https://skmtc.dev/trackstarhq/apis/trackstar-api.md) - [Page](https://skmtc.dev/trackstarhq/apis/trackstar-api/changes/wms/returns/post)