---
title: "Changes to Create subscription"
method: POST
path: "/subscriptions"
---

# Changes to Create subscription

`POST /subscriptions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 67 of 139 revisions.

- **2026-10-14** `3798546cc4a3`: 2 warning, 2 info
- **2026-10-12** `80eb0267435c`: 1 info
- **2026-10-12** `de915dc839fe`: 1 warning
- **2026-10-12** `e1ac9f73d09c`: 1 info
- **2026-10-12** `9b1ab5a75b5e`: 1 warning, 4 info
- **2026-10-12** `d663503436ad`: 4 warning, 1 info
- **2026-10-10** `dbd15795e0ad`: 4 info
- **2026-10-08** `477ea6131062`: 2 info
- **2026-09-28** `91efded425ee`: 1 warning, 1 info
- **2026-09-28** `fa71deaf653b`: 1 breaking, 1 info
- **2026-09-27** `758871229df8`: 1 warning, 1 info
- **2026-09-23** `c2dd8587a719`: 1 info
- **2026-09-22** `f2b58fc437ea`: 1 info
- **2026-09-21** `9c0812229cd1`: 2 info
- **2026-09-21** `15dcbc3c880b`: 20 info
- **2026-09-21** `56ac1e6adeb7`: 20 warning
- **2026-09-21** `0aa0bf7c01e1`: 22 info
- **2026-09-21** `c730635dc27e`: 20 warning
- **2026-09-21** `063d4dc9bde2`: 18 info
- **2026-09-21** `ca8fb37253e5`: 2 info
- **2026-09-20** `c07da7bc72cd`: 18 warning
- **2026-09-20** `a10f1600271a`: 18 info
- **2026-09-19** `ee9cc26d2500`: 2 warning
- **2026-09-18** `0fb60b40c570`: 2 info
- **2026-09-11** `614c3fd4a9b1`: 1 warning
- **2026-09-09** `ac5fdb062f59`: 9 warning, 6 info
- **2026-09-08** `b83876bc3cb2`: 2 warning
- **2026-09-08** `58f315d20550`: 2 info
- **2026-09-03** `e36fe54e0efb`: 2 warning, 3 info
- **2026-09-02** `87ce400e15de`: 1 warning, 3 info
- **2026-09-01** `fd7112159d0a`: 1 info
- **2026-09-01** `e1d4e27b5677`: 1 breaking, 23 info
- **2026-08-24** `9cd0dab91f5c`: 2 info
- **2026-08-24** `66536658bde6`: 1 info
- **2026-08-21** `d567e8585c2e`: 2 warning
- **2026-08-21** `edf928b9b745`: 2 info
- **2026-08-20** `562f13cf61dd`: 1 warning
- **2026-08-14** `29f14678f58f`: 1 warning, 2 info
- **2026-08-06** `779eeb7cc77b`: 16 info
- **2026-07-31** `50b7421a9690`: 5 info
- **2026-07-15** `f8ecf435d25d`: 6 warning, 6 info
- **2026-07-09** `646d6658479b`: 28 breaking, 8 info
- **2026-07-09** `7d57386313c7`: 112 breaking, 96 warning, 185 info
- **2026-07-09** `4b1a811c4179`: 221 breaking, 98 warning, 124 info
- **2026-07-03** `2c73641f19ac`: 1 info
- **2026-06-29** `7857ddc6e44d`: 2 warning, 3 info
- **2026-06-24** `774ba8074d08`: 1 info
- **2026-06-16** `257509e66883`: 30 info
- **2026-06-12** `7084974acc30`: 3 info
- **2026-06-11** `91e685919832`: 32 warning
- **2026-06-10** `2a40f94de722`: 5 info
- **2026-06-03** `7adf4f33ea1a`: 3 info
- **2026-05-18** `8ec2edea6b20`: 4 warning
- **2026-05-13** `7d5041d23ecb`: 2 info
- **2026-05-13** `7934fabd26c1`: 2 warning, 1 info
- **2026-04-25** `5cfd03c5fc75`: 1 warning
- **2026-04-23** `2ead4d5de7c1`: 6 warning, 5 info
- **2026-04-22** `147c5358b6c7`: 4 info
- **2026-04-21** `a51d090509a7`: 1 breaking, 2 info
- **2026-04-11** `c63b5f36b99e`: 1 warning
- **2026-04-10** `5856ed2fbdd6`: 1 breaking, 6 warning, 9 info
- **2026-04-06** `95af41a12111`: 10 warning, 10 info
- **2026-04-04** `daf147b28b31`: 1 info
- **2026-04-04** `9013edc21339`: 13 breaking
- **2026-04-04** `33afc71210f5`: 1 warning
- **2026-04-04** `3d452eb9ebcc`: 1 info
- **2026-03-20** `fdc2d8c76b76`: 2 info

## Changes

- **2026-10-14** `3798546cc4a3`: 2 warning, 2 info
  - added the new `END_OF_MONTH` enum value to the `payment_terms` response property for the response status `201`
  - added the new `END_OF_NEXT_MONTH` enum value to the `payment_terms` response property for the response status `201`
  - added the new `END_OF_MONTH` enum value to the request property `payment_terms`
  - added the new `END_OF_NEXT_MONTH` enum value to the request property `payment_terms`
- **2026-10-12** `80eb0267435c`: 1 info
  - added the optional property `customer/contact_persons` to the response with the `201` status
- **2026-10-12** `de915dc839fe`: 1 warning
  - removed the optional property `customer/contact_persons` from the response with the `201` status
- **2026-10-12** `e1ac9f73d09c`: 1 info
  - added the optional property `customer/contact_persons` to the response with the `201` status
- **2026-10-12** `9b1ab5a75b5e`: 1 warning, 4 info
  - removed the optional property `customer/contact_persons` from the response with the `201` status
  - added the new optional request property `addons/items/coupons`
  - added the new optional request property `credit_grants/items/proration_behavior`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/addons/items/coupons`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/credit_grants/items/proration_behavior`
- **2026-10-12** `d663503436ad`: 4 warning, 1 info
  - removed the request property `addons/items/coupons`
  - removed the request property `credit_grants/items/proration_behavior`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/addons/items/coupons`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/credit_grants/items/proration_behavior`
  - added the optional property `customer/contact_persons` to the response with the `201` status
- **2026-10-10** `dbd15795e0ad`: 4 info
  - added the new optional request property `addons/items/coupons`
  - added the new optional request property `credit_grants/items/proration_behavior`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/addons/items/coupons`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/credit_grants/items/proration_behavior`
- **2026-10-08** `477ea6131062`: 2 info
  - added the new optional request property `fx_rates`
  - added the optional property `customer/billing_currency` to the response with the `201` status
- **2026-09-28** `91efded425ee`: 1 warning, 1 info
  - added the new `stripe` enum value to the `checkout_session/payment_provider` response property for the response status `201`
  - added the new `stripe` enum value to the request property `checkout/payment_provider`
- **2026-09-28** `fa71deaf653b`: 1 breaking, 1 info
  - removed the enum value `stripe` of the request property `checkout/payment_provider`
  - removed the `stripe` enum value from the `checkout_session/payment_provider` response property for the response status `201`
- **2026-09-27** `758871229df8`: 1 warning, 1 info
  - added the new `stripe` enum value to the `checkout_session/payment_provider` response property for the response status `201`
  - added the new `stripe` enum value to the request property `checkout/payment_provider`
- **2026-09-23** `c2dd8587a719`: 1 info
  - added the optional property `entitlements/items/entitlement/grant_state/allowances/items/quota_crossed_at` to the response with the `201` status
- **2026-09-22** `f2b58fc437ea`: 1 info
  - added the optional property `entitlements/items/entitlement/buckets/items/grant_unlimited` to the response with the `201` status
- **2026-09-21** `9c0812229cd1`: 2 info
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_unlimited`
  - added the new optional request property `override_entitlements/items/grant_unlimited`
- **2026-09-21** `15dcbc3c880b`: 20 info
  - added the new optional request property `checkout/entity_creation_options`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/aggregation_mode`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_allocation_behavior`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_unit`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_value`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_measure`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_quota`
  - added the new optional request property `override_entitlements/items/aggregation_mode`
  - added the new optional request property `override_entitlements/items/grant_allocation_behavior`
  - added the new optional request property `override_entitlements/items/grant_duration_unit`
  - added the new optional request property `override_entitlements/items/grant_duration_value`
  - added the new optional request property `override_entitlements/items/grant_measure`
  - added the new optional request property `override_entitlements/items/grant_quota`
  - added the optional property `checkout_session/entity_creation_result` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_duration_unit` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_duration_value` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_measure` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_quota` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_state` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_unlimited` to the response with the `201` status
- **2026-09-21** `56ac1e6adeb7`: 20 warning
  - removed the request property `checkout/entity_creation_options`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/aggregation_mode`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_allocation_behavior`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_unit`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_value`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_measure`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_quota`
  - removed the request property `override_entitlements/items/aggregation_mode`
  - removed the request property `override_entitlements/items/grant_allocation_behavior`
  - removed the request property `override_entitlements/items/grant_duration_unit`
  - removed the request property `override_entitlements/items/grant_duration_value`
  - removed the request property `override_entitlements/items/grant_measure`
  - removed the request property `override_entitlements/items/grant_quota`
  - removed the optional property `checkout_session/entity_creation_result` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_duration_unit` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_duration_value` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_measure` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_quota` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_state` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_unlimited` from the response with the `201` status
- **2026-09-21** `0aa0bf7c01e1`: 22 info
  - added the new optional request property `addons/items/change_at`
  - added the new optional request property `checkout/entity_creation_options`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/addons/items/change_at`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/aggregation_mode`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_allocation_behavior`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_unit`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_value`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_measure`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_quota`
  - added the new optional request property `override_entitlements/items/aggregation_mode`
  - added the new optional request property `override_entitlements/items/grant_allocation_behavior`
  - added the new optional request property `override_entitlements/items/grant_duration_unit`
  - added the new optional request property `override_entitlements/items/grant_duration_value`
  - added the new optional request property `override_entitlements/items/grant_measure`
  - added the new optional request property `override_entitlements/items/grant_quota`
  - added the optional property `checkout_session/entity_creation_result` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_duration_unit` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_duration_value` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_measure` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_quota` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_state` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_unlimited` to the response with the `201` status
- **2026-09-21** `c730635dc27e`: 20 warning
  - removed the request property `addons/items/change_at`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/addons/items/change_at`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/aggregation_mode`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_allocation_behavior`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_unit`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_value`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_measure`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_quota`
  - removed the request property `override_entitlements/items/aggregation_mode`
  - removed the request property `override_entitlements/items/grant_allocation_behavior`
  - removed the request property `override_entitlements/items/grant_duration_unit`
  - removed the request property `override_entitlements/items/grant_duration_value`
  - removed the request property `override_entitlements/items/grant_measure`
  - removed the request property `override_entitlements/items/grant_quota`
  - removed the optional property `entitlements/items/entitlement/grant_duration_unit` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_duration_value` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_measure` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_quota` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_state` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_unlimited` from the response with the `201` status
- **2026-09-21** `063d4dc9bde2`: 18 info
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/aggregation_mode`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_allocation_behavior`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_unit`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_value`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_measure`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_quota`
  - added the new optional request property `override_entitlements/items/aggregation_mode`
  - added the new optional request property `override_entitlements/items/grant_allocation_behavior`
  - added the new optional request property `override_entitlements/items/grant_duration_unit`
  - added the new optional request property `override_entitlements/items/grant_duration_value`
  - added the new optional request property `override_entitlements/items/grant_measure`
  - added the new optional request property `override_entitlements/items/grant_quota`
  - added the optional property `entitlements/items/entitlement/grant_duration_unit` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_duration_value` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_measure` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_quota` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_state` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_unlimited` to the response with the `201` status
- **2026-09-21** `ca8fb37253e5`: 2 info
  - added the new optional request property `addons/items/change_at`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/addons/items/change_at`
- **2026-09-20** `c07da7bc72cd`: 18 warning
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/aggregation_mode`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_allocation_behavior`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_unit`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_value`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_measure`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_quota`
  - removed the request property `override_entitlements/items/aggregation_mode`
  - removed the request property `override_entitlements/items/grant_allocation_behavior`
  - removed the request property `override_entitlements/items/grant_duration_unit`
  - removed the request property `override_entitlements/items/grant_duration_value`
  - removed the request property `override_entitlements/items/grant_measure`
  - removed the request property `override_entitlements/items/grant_quota`
  - removed the optional property `entitlements/items/entitlement/grant_duration_unit` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_duration_value` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_measure` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_quota` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_state` from the response with the `201` status
  - removed the optional property `entitlements/items/entitlement/grant_unlimited` from the response with the `201` status
- **2026-09-20** `a10f1600271a`: 18 info
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/aggregation_mode`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_allocation_behavior`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_unit`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_duration_value`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_measure`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements/items/grant_quota`
  - added the new optional request property `override_entitlements/items/aggregation_mode`
  - added the new optional request property `override_entitlements/items/grant_allocation_behavior`
  - added the new optional request property `override_entitlements/items/grant_duration_unit`
  - added the new optional request property `override_entitlements/items/grant_duration_value`
  - added the new optional request property `override_entitlements/items/grant_measure`
  - added the new optional request property `override_entitlements/items/grant_quota`
  - added the optional property `entitlements/items/entitlement/grant_duration_unit` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_duration_value` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_measure` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_quota` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_state` to the response with the `201` status
  - added the optional property `entitlements/items/entitlement/grant_unlimited` to the response with the `201` status
- **2026-09-19** `ee9cc26d2500`: 2 warning
  - removed the request property `addons/items/change_at`
  - removed the request property `inheritance/grouped_invoicing_children_to_create/items/addons/items/change_at`
- **2026-09-18** `0fb60b40c570`: 2 info
  - added the new optional request property `addons/items/change_at`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/addons/items/change_at`
- **2026-09-11** `614c3fd4a9b1`: 1 warning
  - added the new `pay_invoice` enum value to the `checkout_session/action` response property for the response status `201`
- **2026-09-09** `ac5fdb062f59`: 9 warning, 6 info
  - removed the optional property `checkout_session/configuration` from the response with the `201` status
  - removed the optional property `checkout_session/created_by` from the response with the `201` status
  - removed the optional property `checkout_session/environment_id` from the response with the `201` status
  - removed the optional property `checkout_session/payment_provider_config` from the response with the `201` status
  - removed the optional property `checkout_session/provider_result` from the response with the `201` status
  - removed the optional property `checkout_session/result` from the response with the `201` status
  - removed the optional property `checkout_session/status` from the response with the `201` status
  - removed the optional property `checkout_session/tenant_id` from the response with the `201` status
  - removed the optional property `checkout_session/updated_by` from the response with the `201` status
  - added the new optional request property `line_item_grouping`
  - added the optional property `checkout_session/next_poll_after_ms` to the response with the `201` status
  - added the optional property `checkout_session/payment` to the response with the `201` status
  - added the optional property `checkout_session/stale` to the response with the `201` status
  - added the optional property `checkout_session/terminal` to the response with the `201` status
  - added the optional property `line_item_grouping` to the response with the `201` status
- **2026-09-08** `b83876bc3cb2`: 2 warning
  - removed the request property `line_item_grouping`
  - removed the optional property `line_item_grouping` from the response with the `201` status
- **2026-09-08** `58f315d20550`: 2 info
  - added the new optional request property `line_item_grouping`
  - added the optional property `line_item_grouping` to the response with the `201` status
- **2026-09-03** `e36fe54e0efb`: 2 warning, 3 info
  - removed the request property `checkout/payment_provider_config/customer_present`
  - removed the optional property `checkout_session/payment_provider_config/customer_present` from the response with the `201` status
  - added the new optional request property `checkout/payment_provider_config/customer_not_present`
  - added the optional property `checkout_session/payment_provider_config/customer_not_present` to the response with the `201` status
  - added the optional property `entitlements/items/feature/alert_settings/alert_threshold_type` to the response with the `201` status
- **2026-09-02** `87ce400e15de`: 1 warning, 3 info
  - added the new `chargebee` enum value to the `checkout_session/payment_provider` response property for the response status `201`
  - added the new optional request property `checkout/payment_provider_config/customer_present`
  - added the new `chargebee` enum value to the request property `checkout/payment_provider`
  - added the optional property `checkout_session/payment_provider_config/customer_present` to the response with the `201` status
- **2026-09-01** `fd7112159d0a`: 1 info
  - the request property `include_price_ids` became optional
- **2026-09-01** `e1d4e27b5677`: 1 breaking, 23 info
  - added the new required request property `include_price_ids`
  - added the new optional request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/bucket_size`
  - added the new optional request property `addons/items/override_line_items/items/bucket_size`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/bucket_size`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/addons/items/override_line_items/items/bucket_size`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/bucket_size`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/line_items/items/commitment_time_buckets/items/price/bucket_size`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/line_items/items/price/bucket_size`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_line_items/items/bucket_size`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/phases/items/line_items/items/commitment_time_buckets/items/price/bucket_size`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/phases/items/line_items/items/price/bucket_size`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/phases/items/override_line_items/items/bucket_size`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/tax_rate_overrides/items/tax_behavior`
  - added the new optional request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/bucket_size`
  - added the new optional request property `line_items/items/commitment_time_buckets/items/price/bucket_size`
  - added the new optional request property `line_items/items/price/bucket_size`
  - added the new optional request property `override_line_items/items/bucket_size`
  - added the new optional request property `phases/items/line_items/items/commitment_time_buckets/items/price/bucket_size`
  - added the new optional request property `phases/items/line_items/items/price/bucket_size`
  - added the new optional request property `phases/items/override_line_items/items/bucket_size`
  - added the new optional request property `tax_rate_overrides/items/tax_behavior`
  - added the optional property `coupon_associations/items/subscription_line_item/price/bucket_size` to the response with the `201` status
  - added the optional property `customer/tax_treatment` to the response with the `201` status
  - added the optional property `line_items/items/price/bucket_size` to the response with the `201` status
- **2026-08-24** `9cd0dab91f5c`: 2 info
  - added the optional property `coupon_associations/items/subscription_line_item/price/plan/price_sync_status` to the response with the `201` status
  - added the optional property `plan/price_sync_status` to the response with the `201` status
- **2026-08-24** `66536658bde6`: 1 info
  - added the optional property `coupon_associations/items/subscription_line_item/price/feature` to the response with the `201` status
- **2026-08-21** `d567e8585c2e`: 2 warning
  - removed the optional property `coupon_associations/items/subscription_line_item/price/plan/price_sync_status` from the response with the `201` status
  - removed the optional property `plan/price_sync_status` from the response with the `201` status
- **2026-08-21** `edf928b9b745`: 2 info
  - added the optional property `coupon_associations/items/subscription_line_item/price/plan/price_sync_status` to the response with the `201` status
  - added the optional property `plan/price_sync_status` to the response with the `201` status
- **2026-08-20** `562f13cf61dd`: 1 warning
  - added the new `subscription_line_item` enum value to the `customer/integrations/items/entity_type` response property for the response status `201`
- **2026-08-14** `29f14678f58f`: 1 warning, 2 info
  - added the new `subscription_period` enum value to the `entitlements/items/entitlement/buckets/items/grant_duration_unit` response property for the response status `201`
  - added the new optional request property `checkout`
  - added the optional property `checkout_session` to the response with the `201` status
- **2026-08-06** `779eeb7cc77b`: 16 info
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/addons`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/commitment_amount`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/commitment_duration`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/coupons`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/credit_grants`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/enable_true_up`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/line_item_commitments`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/line_item_coupons`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/line_items`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/overage_factor`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_entitlements`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/override_line_items`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/phases`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/subscription_coupons`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/tax_rate_overrides`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create/items/trial_period_days`
- **2026-07-31** `50b7421a9690`: 5 info
  - added the new optional request property `addons/items/override_line_items`
  - added the new optional request property `inheritance/grouped_invoicing_children_to_create`
  - added the optional property `coupon_associations/items/subscription_line_item/meter` to the response with the `201` status
  - added the optional property `entitlements` to the response with the `201` status
  - added the optional property `line_items/items/meter` to the response with the `201` status
- **2026-07-15** `f8ecf435d25d`: 6 warning, 6 info
  - added the new `ADDON` enum value to the `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/scope` response property for the response status `201`
  - added the new `ADDON` enum value to the `credit_grants/items/scope` response property for the response status `201`
  - added the new `ADDON` enum value to the `plan/credit_grants/items/scope` response property for the response status `201`
  - added the new `invoice_line_item` enum value to the `customer/integrations/items/entity_type` response property for the response status `201`
  - added the new `not_implemented` enum value to the `code` response property for the response status `400`
  - added the new `not_implemented` enum value to the `code` response property for the response status `500`
  - added the new optional request property `credit_grants/items/addon_id`
  - added the new `ADDON` enum value to the request property `credit_grants/items/scope`
  - added the optional property `coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/addon_id` to the response with the `201` status
  - added the optional property `credit_grants/items/addon_id` to the response with the `201` status
  - added the optional property `customer/contact` to the response with the `201` status
  - added the optional property `plan/credit_grants/items/addon_id` to the response with the `201` status
- **2026-07-09** `646d6658479b`: 28 breaking, 8 info
  - the `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/end_date` request property format changed from no format to `date-time`
  - the `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/start_date` request property format changed from no format to `date-time`
  - the `addons/items/start_date` request property format changed from no format to `date-time`
  - the `billing_anchor` request property format changed from no format to `date-time`
  - the `credit_grants/items/end_date` request property format changed from no format to `date-time`
  - the `credit_grants/items/start_date` request property format changed from no format to `date-time`
  - the `end_date` request property format changed from no format to `date-time`
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/end_date` request property format changed from no format to `date-time`
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/start_date` request property format changed from no format to `date-time`
  - the `line_items/items/commitment_time_buckets/items/price/end_date` request property format changed from no format to `date-time`
  - the `line_items/items/commitment_time_buckets/items/price/start_date` request property format changed from no format to `date-time`
  - the `line_items/items/end_date` request property format changed from no format to `date-time`
  - the `line_items/items/price/end_date` request property format changed from no format to `date-time`
  - the `line_items/items/price/start_date` request property format changed from no format to `date-time`
  - the `line_items/items/start_date` request property format changed from no format to `date-time`
  - the `phases/items/end_date` request property format changed from no format to `date-time`
  - the `phases/items/line_items/items/commitment_time_buckets/items/price/end_date` request property format changed from no format to `date-time`
  - the `phases/items/line_items/items/commitment_time_buckets/items/price/start_date` request property format changed from no format to `date-time`
  - the `phases/items/line_items/items/end_date` request property format changed from no format to `date-time`
  - the `phases/items/line_items/items/price/end_date` request property format changed from no format to `date-time`
  - the `phases/items/line_items/items/price/start_date` request property format changed from no format to `date-time`
  - the `phases/items/line_items/items/start_date` request property format changed from no format to `date-time`
  - the `phases/items/start_date` request property format changed from no format to `date-time`
  - the `phases/items/subscription_coupons/items/end_date` request property format changed from no format to `date-time`
  - the `phases/items/subscription_coupons/items/start_date` request property format changed from no format to `date-time`
  - the `start_date` request property format changed from no format to `date-time`
  - the `subscription_coupons/items/end_date` request property format changed from no format to `date-time`
  - the `subscription_coupons/items/start_date` request property format changed from no format to `date-time`
  - the `billing_period_count` request property default value `1` was removed
  - the `billing_period_count` request property default value `1` was removed
  - the `billing_period_count` request property default value `1` was removed
  - the `billing_period_count` request property default value `1` was removed
  - the `billing_period_count` request property default value `1` was removed
  - the `billing_period_count` response's property default value `1` was removed for the status `201`
  - the `billing_period_count` response's property default value `1` was removed for the status `201`
  - the `billing_period_count` response's property default value `1` was removed for the status `201`
- **2026-07-09** `7d57386313c7`: 112 breaking, 96 warning, 185 info
  - request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type` was restricted to a list of enum values
  - request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/invoice_cadence` was restricted to a list of enum values
  - request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/price_unit_type` was restricted to a list of enum values
  - request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/type` was restricted to a list of enum values
  - request property `addons/items/proration_behavior` was restricted to a list of enum values
  - request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type` was restricted to a list of enum values
  - request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/invoice_cadence` was restricted to a list of enum values
  - request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/price_unit_type` was restricted to a list of enum values
  - request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/type` was restricted to a list of enum values
  - request property `line_items/items/commitment_time_buckets/items/price/entity_type` was restricted to a list of enum values
  - request property `line_items/items/commitment_time_buckets/items/price/invoice_cadence` was restricted to a list of enum values
  - request property `line_items/items/commitment_time_buckets/items/price/price_unit_type` was restricted to a list of enum values
  - request property `line_items/items/commitment_time_buckets/items/price/type` was restricted to a list of enum values
  - request property `line_items/items/price/invoice_cadence` was restricted to a list of enum values
  - request property `line_items/items/price/price_unit_type` was restricted to a list of enum values
  - request property `line_items/items/price/type` was restricted to a list of enum values
  - request property `line_items/items/proration_behavior` was restricted to a list of enum values
  - request property `payment_behavior` was restricted to a list of enum values
  - request property `payment_terms` was restricted to a list of enum values
  - request property `phases/items/line_items/items/commitment_time_buckets/items/price/entity_type` was restricted to a list of enum values
  - request property `phases/items/line_items/items/commitment_time_buckets/items/price/invoice_cadence` was restricted to a list of enum values
  - request property `phases/items/line_items/items/commitment_time_buckets/items/price/price_unit_type` was restricted to a list of enum values
  - request property `phases/items/line_items/items/commitment_time_buckets/items/price/type` was restricted to a list of enum values
  - request property `phases/items/line_items/items/price/invoice_cadence` was restricted to a list of enum values
  - request property `phases/items/line_items/items/price/price_unit_type` was restricted to a list of enum values
  - request property `phases/items/line_items/items/price/type` was restricted to a list of enum values
  - request property `phases/items/line_items/items/proration_behavior` was restricted to a list of enum values
  - request property `proration_behavior` was restricted to a list of enum values
  - request property `subscription_status` was restricted to a list of enum values
  - the `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type` request property type changed from no type to `string`
  - the `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/invoice_cadence` request property type changed from no type to `string`
  - the `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/price_unit_type` request property type changed from no type to `string`
  - the `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/transform_quantity` request property type changed from no type to `object`
  - the `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/type` request property type changed from no type to `string`
  - the `addons/items/proration_behavior` request property type changed from no type to `string`
  - the `credit_grants/items/metadata` request property type changed from no type to `object`
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type` request property type changed from no type to `string`
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/invoice_cadence` request property type changed from no type to `string`
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/price_unit_type` request property type changed from no type to `string`
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/transform_quantity` request property type changed from no type to `object`
  - …353 more
- **2026-07-09** `4b1a811c4179`: 221 breaking, 98 warning, 124 info
  - removed the enum value `15 NET` of the request property `payment_terms`
  - removed the enum value `30 NET` of the request property `payment_terms`
  - removed the enum value `45 NET` of the request property `payment_terms`
  - removed the enum value `60 NET` of the request property `payment_terms`
  - removed the enum value `75 NET` of the request property `payment_terms`
  - removed the enum value `90 NET` of the request property `payment_terms`
  - removed the enum value `ADDON` of the request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `ADDON` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `ADDON` of the request property `line_items/items/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `ADDON` of the request property `phases/items/line_items/items/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `ADVANCE` of the request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/invoice_cadence`
  - removed the enum value `ADVANCE` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/invoice_cadence`
  - removed the enum value `ADVANCE` of the request property `line_items/items/commitment_time_buckets/items/price/invoice_cadence`
  - removed the enum value `ADVANCE` of the request property `line_items/items/price/invoice_cadence`
  - removed the enum value `ADVANCE` of the request property `phases/items/line_items/items/commitment_time_buckets/items/price/invoice_cadence`
  - removed the enum value `ADVANCE` of the request property `phases/items/line_items/items/price/invoice_cadence`
  - removed the enum value `ARREAR` of the request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/invoice_cadence`
  - removed the enum value `ARREAR` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/invoice_cadence`
  - removed the enum value `ARREAR` of the request property `line_items/items/commitment_time_buckets/items/price/invoice_cadence`
  - removed the enum value `ARREAR` of the request property `line_items/items/price/invoice_cadence`
  - removed the enum value `ARREAR` of the request property `phases/items/line_items/items/commitment_time_buckets/items/price/invoice_cadence`
  - removed the enum value `ARREAR` of the request property `phases/items/line_items/items/price/invoice_cadence`
  - removed the enum value `COSTSHEET` of the request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `COSTSHEET` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `COSTSHEET` of the request property `line_items/items/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `COSTSHEET` of the request property `phases/items/line_items/items/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `CUSTOM` of the request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/price_unit_type`
  - removed the enum value `CUSTOM` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/price_unit_type`
  - removed the enum value `CUSTOM` of the request property `line_items/items/commitment_time_buckets/items/price/price_unit_type`
  - removed the enum value `CUSTOM` of the request property `line_items/items/price/price_unit_type`
  - removed the enum value `CUSTOM` of the request property `phases/items/line_items/items/commitment_time_buckets/items/price/price_unit_type`
  - removed the enum value `CUSTOM` of the request property `phases/items/line_items/items/price/price_unit_type`
  - removed the enum value `FIAT` of the request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/price_unit_type`
  - removed the enum value `FIAT` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/price_unit_type`
  - removed the enum value `FIAT` of the request property `line_items/items/commitment_time_buckets/items/price/price_unit_type`
  - removed the enum value `FIAT` of the request property `line_items/items/price/price_unit_type`
  - removed the enum value `FIAT` of the request property `phases/items/line_items/items/commitment_time_buckets/items/price/price_unit_type`
  - removed the enum value `FIAT` of the request property `phases/items/line_items/items/price/price_unit_type`
  - removed the enum value `FIXED` of the request property `addons/items/line_item_commitments/additionalProperties/commitment_time_buckets/items/price/type`
  - removed the enum value `FIXED` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/type`
  - …403 more
- **2026-07-03** `2c73641f19ac`: 1 info
  - added the new optional request property `override_entitlements/items/config_value`
- **2026-06-29** `7857ddc6e44d`: 2 warning, 3 info
  - removed the request property `customer_timezone`
  - removed the optional property `customer_timezone` from the response with the `201` status
  - added the new optional request property `timezone`
  - added the optional property `customer/timezone` to the response with the `201` status
  - added the optional property `timezone` to the response with the `201` status
- …earlier changes are on the page: https://skmtc.dev/flexprice/apis/flexprice-api/changes/subscriptions/post

---

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