---
title: "Changes to Create a line item"
method: POST
path: "/line_items"
---

# Changes to Create a line item

`POST /line_items`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 11 revisions.

- **2026-10-13** `7626ac743941`: 1 info
- **2026-10-08** `71dbd5f83326`: 2 info
- **2026-07-13** `859097ed3fe6`: 19 breaking, 126 warning, 338 info

## Changes

- **2026-10-13** `7626ac743941`: 1 info
  - added the new optional request property `data/relationships/item/oneOf[#/components/schemas/shipment]/data/attributes/store_shipment_policy`
- **2026-10-08** `71dbd5f83326`: 2 info
  - request property `data/relationships/item/oneOf[#/components/schemas/shipment]/data/relationships/shipment_line_items` reactivated
  - added the optional property `data/relationships/attachments` to the response with the `201` status
- **2026-07-13** `859097ed3fe6`: 19 breaking, 126 warning, 338 info
  - added the new required request property `data/relationships/item/data`
  - added the new required request property `data/relationships/order/data`
  - request property `data/attributes/item_type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/adjustment]/data/type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/bundle]/data/type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/fixedAmountPromotion]/data/type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/freeShippingPromotion]/data/type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/giftCard]/data/attributes/status` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/giftCard]/data/type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/paymentMethod]/data/attributes/payment_source_type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/paymentMethod]/data/type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/percentageDiscountPromotion]/data/type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/shipment]/data/attributes/status` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/shipment]/data/type` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/sku]/data/attributes/unit_of_weight` was restricted to a list of enum values
  - request property `data/relationships/item/oneOf[#/components/schemas/sku]/data/type` was restricted to a list of enum values
  - request property `data/type` was restricted to a list of enum values
  - the `data/relationships/item/oneOf[#/components/schemas/giftCard]/data/attributes/balance_max_cents` request property type changed from `string` to `integer, null`
  - removed the request property `data/relationships/item/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/adjustment]/data/attributes/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/bundle]/data/attributes/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/bundle]/data/relationships/attachments/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/bundle]/data/relationships/attachments/type`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/bundle]/data/relationships/market/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/bundle]/data/relationships/market/type`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/bundle]/data/relationships/sku_list/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/bundle]/data/relationships/sku_list/type`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/bundle]/data/relationships/skus/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/bundle]/data/relationships/skus/type`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/attributes/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/relationships/attachments/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/relationships/attachments/type`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/relationships/coupon_codes_promotion_rule/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/relationships/coupon_codes_promotion_rule/type`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/relationships/market/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/relationships/market/type`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/relationships/order_amount_promotion_rule/id`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/relationships/order_amount_promotion_rule/type`
  - removed the request property `data/relationships/item/oneOf[#/components/schemas/externalPromotion]/data/relationships/promotion_rules/id`
  - …443 more

---

[Operation](https://skmtc.dev/commercelayer/apis/commerce-layer-api/docs/line_items/post.md) - [API](https://skmtc.dev/commercelayer/apis/commerce-layer-api.md) - [Page](https://skmtc.dev/commercelayer/apis/commerce-layer-api/changes/line_items/post)