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

# Changes to Add addon to subscription

`POST /subscriptions/addon`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 67 of 139 revisions.

- **2026-10-21** `84cb4a3af400`: 1 info
- **2026-10-15** `96879a6887fc`: 1 info
- **2026-10-14** `3798546cc4a3`: 11 warning, 4 info
- **2026-10-12** `80eb0267435c`: 2 info
- **2026-10-12** `de915dc839fe`: 2 warning
- **2026-10-12** `e1ac9f73d09c`: 2 info
- **2026-10-12** `9b1ab5a75b5e`: 2 warning, 1 info
- **2026-10-12** `d663503436ad`: 1 warning, 2 info
- **2026-10-10** `dbd15795e0ad`: 1 info
- **2026-10-08** `477ea6131062`: 4 info
- **2026-09-28** `91efded425ee`: 3 warning, 1 info
- **2026-09-28** `fa71deaf653b`: 1 breaking, 3 info
- **2026-09-27** `758871229df8`: 3 warning, 1 info
- **2026-09-23** `c2dd8587a719`: 1 info
- **2026-09-22** `f2b58fc437ea`: 1 info
- **2026-09-21** `15dcbc3c880b`: 10 info
- **2026-09-21** `56ac1e6adeb7`: 10 warning
- **2026-09-21** `0aa0bf7c01e1`: 11 info
- **2026-09-21** `c730635dc27e`: 7 warning
- **2026-09-21** `063d4dc9bde2`: 6 info
- **2026-09-21** `ca8fb37253e5`: 1 info
- **2026-09-20** `c07da7bc72cd`: 6 warning
- **2026-09-20** `a10f1600271a`: 6 info
- **2026-09-19** `ee9cc26d2500`: 1 warning
- **2026-09-18** `0fb60b40c570`: 1 info
- **2026-09-12** `aeb807837043`: 1 info
- **2026-09-11** `614c3fd4a9b1`: 2 warning, 1 info
- **2026-09-09** `ac5fdb062f59`: 18 warning, 11 info
- **2026-09-08** `b83876bc3cb2`: 1 warning
- **2026-09-08** `58f315d20550`: 1 info
- **2026-09-05** `7cecefe693ce`: 1 warning
- **2026-09-05** `476e8b9db8c2`: 1 info
- **2026-09-03** `e36fe54e0efb`: 3 warning, 4 info
- **2026-09-02** `87ce400e15de`: 2 warning, 4 info
- **2026-09-01** `e1d4e27b5677`: 1 warning, 10 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`: 2 warning, 1 info
- **2026-08-14** `29f14678f58f`: 2 warning, 3 info
- **2026-07-31** `50b7421a9690`: 4 info
- **2026-07-15** `f8ecf435d25d`: 7 warning, 6 info
- **2026-07-09** `646d6658479b`: 3 breaking, 5 info
- **2026-07-09** `7d57386313c7`: 76 breaking, 127 warning, 117 info
- **2026-07-09** `4b1a811c4179`: 166 breaking, 100 warning, 130 info
- **2026-06-29** `7857ddc6e44d`: 1 warning, 2 info
- **2026-06-24** `774ba8074d08`: 1 info
- **2026-06-16** `257509e66883`: 12 info
- **2026-06-12** `7084974acc30`: 1 info
- **2026-06-11** `91e685919832`: 8 warning
- **2026-06-10** `2a40f94de722`: 2 info
- **2026-06-03** `7adf4f33ea1a`: 4 info
- **2026-05-18** `8ec2edea6b20`: 4 warning
- **2026-05-13** `7d5041d23ecb`: 1 info
- **2026-05-13** `7934fabd26c1`: 2 warning
- **2026-04-25** `5cfd03c5fc75`: 1 warning
- **2026-04-23** `2ead4d5de7c1`: 3 warning, 3 info
- **2026-04-22** `147c5358b6c7`: 1 warning, 3 info
- **2026-04-21** `a51d090509a7`: 1 breaking, 1 warning, 1 info
- **2026-04-10** `5856ed2fbdd6`: 6 warning, 4 info
- **2026-04-06** `95af41a12111`: 6 warning, 9 info
- **2026-04-04** `daf147b28b31`: 1 info
- **2026-04-04** `9013edc21339`: 1 breaking
- **2026-04-04** `33afc71210f5`: 1 warning
- **2026-04-04** `3d452eb9ebcc`: 1 info
- **2026-03-02** `8ab89ff34fdc`: 1 info

## Changes

- **2026-10-21** `84cb4a3af400`: 1 info
  - added the optional property `invoice/hosted_invoice_url` to the response with the `200` status
- **2026-10-15** `96879a6887fc`: 1 info
  - added the optional property `synced_price_sequence` to the response with the `200` status
- **2026-10-14** `3798546cc4a3`: 11 warning, 4 info
  - added the new `END_OF_MONTH` enum value to the `invoice/subscription/payment_terms` response property for the response status `200`
  - added the new `END_OF_NEXT_MONTH` enum value to the `invoice/subscription/payment_terms` response property for the response status `200`
  - added the new `credit_note` enum value to the `invoice/taxes/items/entity_type` response property for the response status `200`
  - added the new `not_collecting` enum value to the `invoice/tax_exemption_reason_code` response property for the response status `200`
  - added the new `not_collecting` enum value to the `invoice/tax_summary/exemption/reason_code` response property for the response status `200`
  - added the new `not_subject_to_tax` enum value to the `invoice/tax_exemption_reason_code` response property for the response status `200`
  - added the new `not_subject_to_tax` enum value to the `invoice/tax_summary/exemption/reason_code` response property for the response status `200`
  - added the new `not_supported` enum value to the `invoice/tax_exemption_reason_code` response property for the response status `200`
  - added the new `not_supported` enum value to the `invoice/tax_summary/exemption/reason_code` response property for the response status `200`
  - added the new `reverse_charge` enum value to the `invoice/tax_exemption_reason_code` response property for the response status `200`
  - added the new `reverse_charge` enum value to the `invoice/tax_summary/exemption/reason_code` response property for the response status `200`
  - added the optional property `invoice/taxes/items/external_tax_details` to the response with the `200` status
  - added the optional property `invoice/taxes/items/provider` to the response with the `200` status
  - added the optional property `invoice/taxes/items/tax_transaction_id` to the response with the `200` status
  - added the optional property `invoice/taxes/items/tax_transaction_type` to the response with the `200` status
- **2026-10-12** `80eb0267435c`: 2 info
  - added the optional property `invoice/customer/contact_persons` to the response with the `200` status
  - added the optional property `invoice/subscription/customer/contact_persons` to the response with the `200` status
- **2026-10-12** `de915dc839fe`: 2 warning
  - removed the optional property `invoice/customer/contact_persons` from the response with the `200` status
  - removed the optional property `invoice/subscription/customer/contact_persons` from the response with the `200` status
- **2026-10-12** `e1ac9f73d09c`: 2 info
  - added the optional property `invoice/customer/contact_persons` to the response with the `200` status
  - added the optional property `invoice/subscription/customer/contact_persons` to the response with the `200` status
- **2026-10-12** `9b1ab5a75b5e`: 2 warning, 1 info
  - removed the optional property `invoice/customer/contact_persons` from the response with the `200` status
  - removed the optional property `invoice/subscription/customer/contact_persons` from the response with the `200` status
  - added the new optional request property `coupons`
- **2026-10-12** `d663503436ad`: 1 warning, 2 info
  - removed the request property `coupons`
  - added the optional property `invoice/customer/contact_persons` to the response with the `200` status
  - added the optional property `invoice/subscription/customer/contact_persons` to the response with the `200` status
- **2026-10-10** `dbd15795e0ad`: 1 info
  - added the new optional request property `coupons`
- **2026-10-08** `477ea6131062`: 4 info
  - added the optional property `invoice/customer/billing_currency` to the response with the `200` status
  - added the optional property `invoice/fx_conversion` to the response with the `200` status
  - added the optional property `invoice/line_items/items/fx_conversion` to the response with the `200` status
  - added the optional property `invoice/subscription/customer/billing_currency` to the response with the `200` status
- **2026-09-28** `91efded425ee`: 3 warning, 1 info
  - added the new `stripe` enum value to the `checkout_session/payment_provider` response property for the response status `200`
  - added the new `stripe` enum value to the `invoice/checkout_session/payment_provider` response property for the response status `200`
  - added the new `stripe` enum value to the `invoice/subscription/checkout_session/payment_provider` response property for the response status `200`
  - added the new `stripe` enum value to the request property `checkout/payment_provider`
- **2026-09-28** `fa71deaf653b`: 1 breaking, 3 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 `200`
  - removed the `stripe` enum value from the `invoice/checkout_session/payment_provider` response property for the response status `200`
  - removed the `stripe` enum value from the `invoice/subscription/checkout_session/payment_provider` response property for the response status `200`
- **2026-09-27** `758871229df8`: 3 warning, 1 info
  - added the new `stripe` enum value to the `checkout_session/payment_provider` response property for the response status `200`
  - added the new `stripe` enum value to the `invoice/checkout_session/payment_provider` response property for the response status `200`
  - added the new `stripe` enum value to the `invoice/subscription/checkout_session/payment_provider` response property for the response status `200`
  - added the new `stripe` enum value to the request property `checkout/payment_provider`
- **2026-09-23** `c2dd8587a719`: 1 info
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_state/allowances/items/quota_crossed_at` to the response with the `200` status
- **2026-09-22** `f2b58fc437ea`: 1 info
  - added the optional property `invoice/subscription/entitlements/items/entitlement/buckets/items/grant_unlimited` to the response with the `200` status
- **2026-09-21** `15dcbc3c880b`: 10 info
  - added the new optional request property `checkout/entity_creation_options`
  - added the optional property `checkout_session/entity_creation_result` to the response with the `200` status
  - added the optional property `invoice/checkout_session/entity_creation_result` to the response with the `200` status
  - added the optional property `invoice/subscription/checkout_session/entity_creation_result` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_unit` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_value` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_measure` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_quota` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_state` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_unlimited` to the response with the `200` status
- **2026-09-21** `56ac1e6adeb7`: 10 warning
  - removed the request property `checkout/entity_creation_options`
  - removed the optional property `checkout_session/entity_creation_result` from the response with the `200` status
  - removed the optional property `invoice/checkout_session/entity_creation_result` from the response with the `200` status
  - removed the optional property `invoice/subscription/checkout_session/entity_creation_result` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_unit` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_value` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_measure` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_quota` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_state` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_unlimited` from the response with the `200` status
- **2026-09-21** `0aa0bf7c01e1`: 11 info
  - added the new optional request property `change_at`
  - added the new optional request property `checkout/entity_creation_options`
  - added the optional property `checkout_session/entity_creation_result` to the response with the `200` status
  - added the optional property `invoice/checkout_session/entity_creation_result` to the response with the `200` status
  - added the optional property `invoice/subscription/checkout_session/entity_creation_result` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_unit` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_value` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_measure` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_quota` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_state` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_unlimited` to the response with the `200` status
- **2026-09-21** `c730635dc27e`: 7 warning
  - removed the request property `change_at`
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_unit` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_value` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_measure` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_quota` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_state` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_unlimited` from the response with the `200` status
- **2026-09-21** `063d4dc9bde2`: 6 info
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_unit` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_value` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_measure` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_quota` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_state` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_unlimited` to the response with the `200` status
- **2026-09-21** `ca8fb37253e5`: 1 info
  - added the new optional request property `change_at`
- **2026-09-20** `c07da7bc72cd`: 6 warning
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_unit` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_value` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_measure` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_quota` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_state` from the response with the `200` status
  - removed the optional property `invoice/subscription/entitlements/items/entitlement/grant_unlimited` from the response with the `200` status
- **2026-09-20** `a10f1600271a`: 6 info
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_unit` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_duration_value` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_measure` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_quota` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_state` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/entitlement/grant_unlimited` to the response with the `200` status
- **2026-09-19** `ee9cc26d2500`: 1 warning
  - removed the request property `change_at`
- **2026-09-18** `0fb60b40c570`: 1 info
  - added the new optional request property `change_at`
- **2026-09-12** `aeb807837043`: 1 info
  - added the optional property `invoice/source_type` to the response with the `200` status
- **2026-09-11** `614c3fd4a9b1`: 2 warning, 1 info
  - added the new `pay_invoice` enum value to the `checkout_session/action` response property for the response status `200`
  - added the new `pay_invoice` enum value to the `invoice/subscription/checkout_session/action` response property for the response status `200`
  - added the optional property `invoice/checkout_session` to the response with the `200` status
- **2026-09-09** `ac5fdb062f59`: 18 warning, 11 info
  - removed the optional property `checkout_session/configuration` from the response with the `200` status
  - removed the optional property `checkout_session/created_by` from the response with the `200` status
  - removed the optional property `checkout_session/environment_id` from the response with the `200` status
  - removed the optional property `checkout_session/payment_provider_config` from the response with the `200` status
  - removed the optional property `checkout_session/provider_result` from the response with the `200` status
  - removed the optional property `checkout_session/result` from the response with the `200` status
  - removed the optional property `checkout_session/status` from the response with the `200` status
  - removed the optional property `checkout_session/tenant_id` from the response with the `200` status
  - removed the optional property `checkout_session/updated_by` from the response with the `200` status
  - removed the optional property `invoice/subscription/checkout_session/configuration` from the response with the `200` status
  - removed the optional property `invoice/subscription/checkout_session/created_by` from the response with the `200` status
  - removed the optional property `invoice/subscription/checkout_session/environment_id` from the response with the `200` status
  - removed the optional property `invoice/subscription/checkout_session/payment_provider_config` from the response with the `200` status
  - removed the optional property `invoice/subscription/checkout_session/provider_result` from the response with the `200` status
  - removed the optional property `invoice/subscription/checkout_session/result` from the response with the `200` status
  - removed the optional property `invoice/subscription/checkout_session/status` from the response with the `200` status
  - removed the optional property `invoice/subscription/checkout_session/tenant_id` from the response with the `200` status
  - removed the optional property `invoice/subscription/checkout_session/updated_by` from the response with the `200` status
  - added the optional property `checkout_session/next_poll_after_ms` to the response with the `200` status
  - added the optional property `checkout_session/payment` to the response with the `200` status
  - added the optional property `checkout_session/stale` to the response with the `200` status
  - added the optional property `checkout_session/terminal` to the response with the `200` status
  - added the optional property `invoice/custom_currency` to the response with the `200` status
  - added the optional property `invoice/line_items/items/custom_currency` to the response with the `200` status
  - added the optional property `invoice/subscription/checkout_session/next_poll_after_ms` to the response with the `200` status
  - added the optional property `invoice/subscription/checkout_session/payment` to the response with the `200` status
  - added the optional property `invoice/subscription/checkout_session/stale` to the response with the `200` status
  - added the optional property `invoice/subscription/checkout_session/terminal` to the response with the `200` status
  - added the optional property `invoice/subscription/line_item_grouping` to the response with the `200` status
- **2026-09-08** `b83876bc3cb2`: 1 warning
  - removed the optional property `invoice/subscription/line_item_grouping` from the response with the `200` status
- **2026-09-08** `58f315d20550`: 1 info
  - added the optional property `invoice/subscription/line_item_grouping` to the response with the `200` status
- **2026-09-05** `7cecefe693ce`: 1 warning
  - removed the optional property `invoice/line_items/items/description` from the response with the `200` status
- **2026-09-05** `476e8b9db8c2`: 1 info
  - added the optional property `invoice/line_items/items/description` to the response with the `200` status
- **2026-09-03** `e36fe54e0efb`: 3 warning, 4 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 `200` status
  - removed the optional property `invoice/subscription/checkout_session/payment_provider_config/customer_present` from the response with the `200` 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 `200` status
  - added the optional property `invoice/subscription/checkout_session/payment_provider_config/customer_not_present` to the response with the `200` status
  - added the optional property `invoice/subscription/entitlements/items/feature/alert_settings/alert_threshold_type` to the response with the `200` status
- **2026-09-02** `87ce400e15de`: 2 warning, 4 info
  - added the new `chargebee` enum value to the `checkout_session/payment_provider` response property for the response status `200`
  - added the new `chargebee` enum value to the `invoice/subscription/checkout_session/payment_provider` response property for the response status `200`
  - 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 `200` status
  - added the optional property `invoice/subscription/checkout_session/payment_provider_config/customer_present` to the response with the `200` status
- **2026-09-01** `e1d4e27b5677`: 1 warning, 10 info
  - removed the optional property `invoice/taxes/items/tax_rate/fixed_value` from the response with the `200` status
  - added the new optional request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/bucket_size`
  - added the new optional request property `override_line_items/items/bucket_size`
  - added the optional property `invoice/customer/tax_treatment` to the response with the `200` status
  - added the optional property `invoice/subscription/coupon_associations/items/subscription_line_item/price/bucket_size` to the response with the `200` status
  - added the optional property `invoice/subscription/customer/tax_treatment` to the response with the `200` status
  - added the optional property `invoice/subscription/line_items/items/price/bucket_size` to the response with the `200` status
  - added the optional property `invoice/tax_exemption_reason_code` to the response with the `200` status
  - added the optional property `invoice/tax_summary` to the response with the `200` status
  - added the optional property `invoice/taxes/items/tax_behavior` to the response with the `200` status
  - removed the `fixed` enum value from the `invoice/taxes/items/tax_rate/tax_rate_type` response property for the response status `200`
- **2026-08-24** `9cd0dab91f5c`: 2 info
  - added the optional property `invoice/subscription/coupon_associations/items/subscription_line_item/price/plan/price_sync_status` to the response with the `200` status
  - added the optional property `invoice/subscription/plan/price_sync_status` to the response with the `200` status
- **2026-08-24** `66536658bde6`: 1 info
  - added the optional property `invoice/subscription/coupon_associations/items/subscription_line_item/price/feature` to the response with the `200` status
- **2026-08-21** `d567e8585c2e`: 2 warning
  - removed the optional property `invoice/subscription/coupon_associations/items/subscription_line_item/price/plan/price_sync_status` from the response with the `200` status
  - removed the optional property `invoice/subscription/plan/price_sync_status` from the response with the `200` status
- **2026-08-21** `edf928b9b745`: 2 info
  - added the optional property `invoice/subscription/coupon_associations/items/subscription_line_item/price/plan/price_sync_status` to the response with the `200` status
  - added the optional property `invoice/subscription/plan/price_sync_status` to the response with the `200` status
- **2026-08-20** `562f13cf61dd`: 2 warning, 1 info
  - added the new `subscription_line_item` enum value to the `invoice/customer/integrations/items/entity_type` response property for the response status `200`
  - added the new `subscription_line_item` enum value to the `invoice/subscription/customer/integrations/items/entity_type` response property for the response status `200`
  - endpoint deprecated
- **2026-08-14** `29f14678f58f`: 2 warning, 3 info
  - removed the optional property `addon` from the response with the `200` status
  - removed the optional property `subscription` from the response with the `200` status
  - added the new optional request property `checkout`
  - added the optional property `checkout_session` to the response with the `200` status
  - added the optional property `invoice` to the response with the `200` status
- **2026-07-31** `50b7421a9690`: 4 info
  - added the new optional request property `override_line_items`
  - added the optional property `subscription/coupon_associations/items/subscription_line_item/meter` to the response with the `200` status
  - added the optional property `subscription/entitlements` to the response with the `200` status
  - added the optional property `subscription/line_items/items/meter` to the response with the `200` status
- **2026-07-15** `f8ecf435d25d`: 7 warning, 6 info
  - added the new `ADDON` enum value to the `addon/prices/items/plan/credit_grants/items/scope` response property for the response status `200`
  - added the new `ADDON` enum value to the `subscription/coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/scope` response property for the response status `200`
  - added the new `ADDON` enum value to the `subscription/credit_grants/items/scope` response property for the response status `200`
  - added the new `ADDON` enum value to the `subscription/plan/credit_grants/items/scope` response property for the response status `200`
  - added the new `invoice_line_item` enum value to the `subscription/customer/integrations/items/entity_type` response property for the response status `200`
  - 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 optional property `addon/credit_grants` to the response with the `200` status
  - added the optional property `addon/prices/items/plan/credit_grants/items/addon_id` to the response with the `200` status
  - added the optional property `subscription/coupon_associations/items/subscription_line_item/price/plan/credit_grants/items/addon_id` to the response with the `200` status
  - added the optional property `subscription/credit_grants/items/addon_id` to the response with the `200` status
  - added the optional property `subscription/customer/contact` to the response with the `200` status
  - added the optional property `subscription/plan/credit_grants/items/addon_id` to the response with the `200` status
- **2026-07-09** `646d6658479b`: 3 breaking, 5 info
  - 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 `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` response's property default value `1` was removed for the status `200`
  - the `billing_period_count` response's property default value `1` was removed for the status `200`
  - the `billing_period_count` response's property default value `1` was removed for the status `200`
  - the `billing_period_count` response's property default value `1` was removed for the status `200`
- **2026-07-09** `7d57386313c7`: 76 breaking, 127 warning, 117 info
  - 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 `proration_behavior` was restricted to a list of enum values
  - 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`
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/type` request property type changed from no type to `string`
  - the `proration_behavior` request property type changed from no type to `string`
  - the `addon/prices/items/entity_type` response's property type changed from no type to `string` for status `200`
  - the `addon/prices/items/invoice_cadence` response's property type changed from no type to `string` for status `200`
  - the `addon/prices/items/metadata` response's property type changed from no type to `object` for status `200`
  - the `addon/prices/items/meter/aggregation` response's property type changed from no type to `object` for status `200`
  - the `addon/prices/items/meter/filters/items/` response's property type changed from no type to `object` for status `200`
  - the `addon/prices/items/meter/reset_usage` response's property type changed from no type to `string` for status `200`
  - the `addon/prices/items/plan/credit_grants/items/metadata` response's property type changed from no type to `object` for status `200`
  - the `addon/prices/items/plan/credit_grants/items/status` response's property type changed from no type to `string` for status `200`
  - the `addon/prices/items/plan/metadata` response's property type changed from no type to `object` for status `200`
  - the `addon/prices/items/plan/status` response's property type changed from no type to `string` for status `200`
  - the `addon/prices/items/price_unit_tiers/items/` response's property type changed from no type to `object` for status `200`
  - the `addon/prices/items/price_unit_type` response's property type changed from no type to `string` for status `200`
  - the `addon/prices/items/pricing_unit/metadata` response's property type changed from no type to `object` for status `200`
  - the `addon/prices/items/pricing_unit/status` response's property type changed from no type to `string` for status `200`
  - the `addon/prices/items/status` response's property type changed from no type to `string` for status `200`
  - the `addon/prices/items/tiers/items/` response's property type changed from no type to `object` for status `200`
  - the `addon/prices/items/transform_quantity` response's property type changed from no type to `object` for status `200`
  - the `addon/prices/items/type` response's property type changed from no type to `string` for status `200`
  - the `addon/status` response's property type changed from no type to `string` for status `200`
  - the `status` response's property type changed from no type to `string` for status `200`
  - the `subscription/coupon_associations/items/coupon/status` response's property type changed from no type to `string` for status `200`
  - the `subscription/coupon_associations/items/status` response's property type changed from no type to `string` for status `200`
  - the `subscription/coupon_associations/items/subscription_line_item/commitment_time_buckets/items/` response's property type changed from no type to `object` for status `200`
  - the `subscription/coupon_associations/items/subscription_line_item/entity_type` response's property type changed from no type to `string` for status `200`
  - the `subscription/coupon_associations/items/subscription_line_item/invoice_cadence` response's property type changed from no type to `string` for status `200`
  - the `subscription/coupon_associations/items/subscription_line_item/price/entity_type` response's property type changed from no type to `string` for status `200`
  - the `subscription/coupon_associations/items/subscription_line_item/price/invoice_cadence` response's property type changed from no type to `string` for status `200`
  - the `subscription/coupon_associations/items/subscription_line_item/price/metadata` response's property type changed from no type to `object` for status `200`
  - the `subscription/coupon_associations/items/subscription_line_item/price/meter/aggregation` response's property type changed from no type to `object` for status `200`
  - …280 more
- **2026-07-09** `4b1a811c4179`: 166 breaking, 100 warning, 130 info
  - removed the enum value `ADDON` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `ADVANCE` 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_item_commitments/additionalProperties/commitment_time_buckets/items/price/invoice_cadence`
  - removed the enum value `COSTSHEET` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_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 `FIAT` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/price_unit_type`
  - removed the enum value `FIXED` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/type`
  - removed the enum value `PLAN` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `PRICE` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `SUBSCRIPTION` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type`
  - removed the enum value `USAGE` of the request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/type`
  - removed the enum value `create_prorations` of the request property `proration_behavior`
  - removed the enum value `none` of the request property `proration_behavior`
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/entity_type` request property type changed from `string` to no type
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/invoice_cadence` request property type changed from `string` to no type
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/price_unit_type` request property type changed from `string` to no type
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/transform_quantity` request property type changed from `object` to no type
  - the `line_item_commitments/additionalProperties/commitment_time_buckets/items/price/type` request property type changed from `string` to no type
  - the `proration_behavior` request property type changed from `string` to no type
  - the `addon/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/end_date` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/entity_type` response's property type changed from `string` to no type for status `200`
  - the `addon/prices/items/group/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/group/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/invoice_cadence` response's property type changed from `string` to no type for status `200`
  - the `addon/prices/items/metadata` response's property type changed from `object` to no type for status `200`
  - the `addon/prices/items/meter/aggregation` response's property type changed from `object` to no type for status `200`
  - the `addon/prices/items/meter/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/meter/filters/items/` response's property type changed from `object` to no type for status `200`
  - the `addon/prices/items/meter/reset_usage` response's property type changed from `string` to no type for status `200`
  - the `addon/prices/items/meter/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/plan/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/plan/credit_grants/items/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/plan/credit_grants/items/credit_grant_anchor` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/plan/credit_grants/items/end_date` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/plan/credit_grants/items/metadata` response's property type changed from `object` to no type for status `200`
  - the `addon/prices/items/plan/credit_grants/items/start_date` response's property format changed from `date-time` to no format for status `200`
  - the `addon/prices/items/plan/credit_grants/items/status` response's property type changed from `string` to no type for status `200`
  - the `addon/prices/items/plan/credit_grants/items/updated_at` response's property format changed from `date-time` to no format for status `200`
  - …356 more
- **2026-06-29** `7857ddc6e44d`: 1 warning, 2 info
  - removed the optional property `subscription/customer_timezone` from the response with the `200` status
  - added the optional property `subscription/customer/timezone` to the response with the `200` status
  - added the optional property `subscription/timezone` to the response with the `200` status
- **2026-06-24** `774ba8074d08`: 1 info
  - added the optional property `subscription/coupon_associations/items/subscription_line_item` to the response with the `200` status
- **2026-06-16** `257509e66883`: 12 info
  - added the new optional request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/commitment_type`
  - added the new optional request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/commitment_value`
  - added the new optional request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/id`
  - added the new optional request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/overage_factor`
  - added the new optional request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/price`
  - added the new optional request property `line_item_commitments/additionalProperties/commitment_time_buckets/items/true_up_enabled`
  - added the optional property `subscription/line_items/items/commitment_time_buckets/items/commitment_type` to the response with the `200` status
  - added the optional property `subscription/line_items/items/commitment_time_buckets/items/commitment_value` to the response with the `200` status
  - added the optional property `subscription/line_items/items/commitment_time_buckets/items/id` to the response with the `200` status
  - added the optional property `subscription/line_items/items/commitment_time_buckets/items/overage_factor` to the response with the `200` status
  - added the optional property `subscription/line_items/items/commitment_time_buckets/items/price_id` to the response with the `200` status
  - added the optional property `subscription/line_items/items/commitment_time_buckets/items/true_up_enabled` to the response with the `200` status
- **2026-06-12** `7084974acc30`: 1 info
  - added the optional property `subscription/coupon_associations/items/coupon/coupon_code` to the response with the `200` status
- …earlier changes are on the page: https://skmtc.dev/flexprice/apis/flexprice-api/changes/subscriptions/addon/post

---

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