--- title: "Changes to Create subscription" method: POST path: "/api/v1/subscriptions" --- # Changes to Create subscription `POST /api/v1/subscriptions` > Every recorded change to this operation, newest first. ## Timeline Changed in 23 of 54 revisions. - **2026-08-12** (v1) `4e013b4e4a8f`: 16 breaking, 24 info - **2026-06-01** (v1) `07a61fe347a5`: 1 breaking, 1 warning - **2026-05-28** (v1) `ed86d893d43e`: 1 breaking, 1 warning, 2 info - **2026-05-23** (v1) `ac42ddd7b4b4`: 1 breaking, 2 warning, 2 info - **2026-05-18** (v1) `0cdc37620ffb`: 4 breaking, 3 info - **2026-03-31** (v1) `ee465c53a423`: 2 breaking, 17 info - **2026-03-31** (v1) `560215310a09`: 3 breaking, 6 info - **2026-03-27** (v1) `de35c02bb0d2`: 8 breaking, 3 warning, 10 info - **2026-02-23** (v1) `e78cbe818dc6`: 1 breaking, 6 info - **2026-02-19** (v1) `1bbd84c95e41`: 5 breaking, 2 warning - **2026-02-05** (v1) `7e8a9e6e83e4`: 1 info - **2026-02-05** (v1) `f9c417ec1ed4`: 2 info - **2026-01-21** (v1) `9fba45d198be`: 2 info - **2026-01-20** (v1) `665f680338b5`: 2 info - **2025-12-17** (v1) `2244ec0dabe3`: 6 breaking, 22 info - **2025-12-02** (v1) `f3aab0fcd63f`: 1 warning - **2025-10-17** (v1) `b03a38c9dbd4`: 1 breaking, 2 warning, 4 info - **2025-10-16** (v1) `a174f46ee4f8`: 4 info - **2025-10-14** (v1) `532c5edf3ddd`: 9 breaking, 2 warning, 9 info - **2025-10-14** (v1) `da72c03d9734`: 2 info - **2025-07-23** (v1) `cad632d024ce`: 6 breaking, 6 info - **2025-07-22** (v1) `f9622bc2c669`: 1 info - **2025-07-09** (v1) `dece17f86f99`: 1 breaking ## Changes - **2026-08-12** (v1) `4e013b4e4a8f`: 16 breaking, 24 info - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable for the status `201` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable for the status `201` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable for the status `201` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable for the status `201` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable for the status `201` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable for the status `201` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable for the status `201` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable for the status `201` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional for the status `201` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional for the status `201` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional for the status `201` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional for the status `201` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional for the status `201` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional for the status `201` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional for the status `201` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional for the status `201` - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable - the request property `price_components/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable - the request property `price_components/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable - the request property `price_components/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable - the request property `price_components/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable - the request property `price_components/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable - the request property `price_components/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable - the request property `price_components/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable - the request property `price_components/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional - the request property `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional - the request property `price_components/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional - the request property `price_components/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional - the request property `price_components/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional - the request property `price_components/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional - the request property `price_components/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional - the request property `price_components/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional - the request property `price_components/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional - the request property `price_components/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional - **2026-06-01** (v1) `07a61fe347a5`: 1 breaking, 1 warning - removed the required property `entitlements/items/value/oneOf[#/components/schemas/MeteredEntitlementValue]/overage_behavior` from the response with the `201` status - removed the optional property `entitlements/items/value/oneOf[#/components/schemas/MeteredEntitlementValue]/warning_threshold_pct` from the response with the `201` status - **2026-05-28** (v1) `ed86d893d43e`: 1 breaking, 1 warning, 2 info - added `#/components/schemas/BooleanEntitlementValue, #/components/schemas/MeteredEntitlementValue` to the `entitlements/items/value` response property `oneOf` list for the response status `201` - removed the request property `entitlements` - added discriminator to `entitlements/items/value` response property for the response status `201` - removed `subschema #1, subschema #2` from the `entitlements/items/value` response property `oneOf` list for the response status `201` - **2026-05-23** (v1) `ac42ddd7b4b4`: 1 breaking, 2 warning, 2 info - the `price_components/extra_components/items/product_ref` request property type changed from `object` to no type - removed the request property `price_components/extra_components/items/product_ref/id` - removed the request property `price_components/extra_components/items/product_ref/name` - added discriminator to `price_components/extra_components/items/product_ref` request property - added `#/components/schemas/ExistingProductRef, #/components/schemas/NewProductRef` to the `price_components/extra_components/items/product_ref` request property `oneOf` list - **2026-05-18** (v1) `0cdc37620ffb`: 4 breaking, 3 info - added the new required request property `price_components/extra_components/items/product_ref/id` - added the new required request property `price_components/extra_components/items/product_ref/name` - removed `#/components/schemas/ExistingProductRef, #/components/schemas/NewProductRef` from the `price_components/extra_components/items/product_ref` request property `oneOf` list - the `price_components/extra_components/items/product_ref` request property type changed from no type to `object` - added the new optional request property `entitlements` - removed discriminator from `price_components/extra_components/items/product_ref` request property - added the optional property `entitlements` to the response with the `201` status - **2026-03-31** (v1) `ee465c53a423`: 2 breaking, 17 info - the `applied_coupons/items/coupon/discount/oneOf[#/components/schemas/FixedDiscount]/amount` response's property format changed from `decimal` to no format for status `201` - the `applied_coupons/items/coupon/discount/oneOf[#/components/schemas/PercentageDiscount]/percentage` response's property format changed from `decimal` to no format for status `201` - request discriminator property name changed for `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property from `discriminator` to `type` - request discriminator property name changed for `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry` request property from `discriminator` to `type` - request discriminator property name changed for `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing` request property from `discriminator` to `type` - request discriminator property name changed for `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model` request property from `discriminator` to `type` - request discriminator property name changed for `price_components/extra_components/items/price_entry` request property from `discriminator` to `type` - request discriminator property name changed for `price_components/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing` request property from `discriminator` to `type` - request discriminator property name changed for `price_components/extra_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model` request property from `discriminator` to `type` - request discriminator property name changed for `price_components/extra_components/items/product_ref` request property from `discriminator` to `type` - request discriminator property name changed for `price_components/extra_components/items/product_ref/oneOf[#/components/schemas/NewProductRef]/fee_structure` request property from `fee_type` to `type` - request discriminator property name changed for `price_components/overridden_components/items/price_entry` request property from `discriminator` to `type` - request discriminator property name changed for `price_components/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing` request property from `discriminator` to `type` - request discriminator property name changed for `price_components/overridden_components/items/price_entry/oneOf[#/components/schemas/PriceInput]/pricing/oneOf[#/components/schemas/UsagePricing]/model` request property from `discriminator` to `type` - response discriminator property name changed for `add_ons/items/fee` response property from `discriminator` to `type` for the response status `201` - response discriminator property name changed for `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model` response property from `discriminator` to `type` for the response status `201` - response discriminator property name changed for `applied_coupons/items/coupon/discount` response property from `discriminator` to `type` for the response status `201` - response discriminator property name changed for `components/items/fee` response property from `discriminator` to `type` for the response status `201` - response discriminator property name changed for `components/items/fee/oneOf[#/components/schemas/UsageFee]/model` response property from `discriminator` to `type` for the response status `201` - **2026-03-31** (v1) `560215310a09`: 3 breaking, 6 info - removed `subschema #1, subschema #2, subschema #3` from the `payment_methods_config` request property `oneOf` list - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` from the `price_components/extra_components/items/product_ref/oneOf[#/components/schemas/NewProductRef]/fee_structure` request property `oneOf` list - added `#/components/schemas/OnlinePaymentMethodConfig, #/components/schemas/BankTransferPaymentMethodConfig, #/components/schemas/ExternalPaymentMethodConfig` to the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property `oneOf` list for the response status `201` - added discriminator to `payment_methods_config` request property - added discriminator to `price_components/extra_components/items/product_ref/oneOf[#/components/schemas/NewProductRef]/fee_structure` request property - added `#/components/schemas/OnlinePaymentMethodConfig, #/components/schemas/BankTransferPaymentMethodConfig, #/components/schemas/ExternalPaymentMethodConfig` to the `payment_methods_config` request property `oneOf` list - added `#/components/schemas/RateFeeStructure, #/components/schemas/SlotFeeStructure, #/components/schemas/CapacityFeeStructure, #/components/schemas/UsageFeeStructure, #/components/schemas/ExtraRecurringFeeStructure, #/components/schemas/OneTimeFeeStructure` to the `price_components/extra_components/items/product_ref/oneOf[#/components/schemas/NewProductRef]/fee_structure` request property `oneOf` list - added discriminator to `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property for the response status `201` - removed `subschema #1, subschema #2, subschema #3` from the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property `oneOf` list for the response status `201` - **2026-03-27** (v1) `de35c02bb0d2`: 8 breaking, 3 warning, 10 info - the request property `payment_methods_config/oneOf[subschema #2]/account_id` became not nullable - the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry` request property type changed from `object` to no type - the `payment_methods_config/oneOf[subschema #2]/account_id` request property type changed from `string, null` to no type - the `price_components/extra_components/items/price_entry` request property type changed from `object` to no type - the `price_components/extra_components/items/product_ref` request property type changed from `object` to no type - the `price_components/overridden_components/items/price_entry` request property type changed from `object` to no type - added `#/components/schemas/BankAccountId, subschema #1` to the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` response property `oneOf` list for the response status `201` - the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` response's property type changed from `string, null` to no type for status `201` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `400` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `401` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `500` - added discriminator to `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry` request property - added discriminator to `price_components/extra_components/items/price_entry` request property - added discriminator to `price_components/extra_components/items/product_ref` request property - added discriminator to `price_components/overridden_components/items/price_entry` request property - added `#/components/schemas/BankAccountId, subschema #1` to the `payment_methods_config/oneOf[subschema #2]/account_id` request property `oneOf` list - added `#/components/schemas/ExistingPriceRef, #/components/schemas/PriceInput` to the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/oneOf[#/components/schemas/SubscriptionAddOnPriceOverride]/price_entry` request property `oneOf` list - added `#/components/schemas/ExistingPriceRef, #/components/schemas/PriceInput` to the `price_components/extra_components/items/price_entry` request property `oneOf` list - added `#/components/schemas/ExistingPriceRef, #/components/schemas/PriceInput` to the `price_components/overridden_components/items/price_entry` request property `oneOf` list - added `#/components/schemas/ExistingProductRef, #/components/schemas/NewProductRef` to the `price_components/extra_components/items/product_ref` request property `oneOf` list - added the non-success response with the status `429` - **2026-02-23** (v1) `e78cbe818dc6`: 1 breaking, 6 info - removed `#/components/schemas/SubscriptionAddOnOverride` from the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property `oneOf` list - added the new optional request property `add_ons/items/quantity` - added `PRICE_OVERRIDE` discriminator mapping keys to the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property - removed `OVERRIDE` discriminator mapping keys from the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property - added `#/components/schemas/SubscriptionAddOnPriceOverride` to the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property `oneOf` list - added the optional property `add_ons/items/id` to the response with the `201` status - added the required property `add_ons/items/quantity` to the response with the `201` status - **2026-02-19** (v1) `1bbd84c95e41`: 5 breaking, 2 warning - added the new required request property `price_components/extra_components/items/name` - added the new required request property `price_components/extra_components/items/price_entry` - added the new required request property `price_components/extra_components/items/product_ref` - added the new required request property `price_components/overridden_components/items/name` - added the new required request property `price_components/overridden_components/items/price_entry` - removed the request property `price_components/extra_components/items/component` - removed the request property `price_components/overridden_components/items/component` - **2026-02-05** (v1) `7e8a9e6e83e4`: 1 info - added the new optional request property `skip_past_invoices` - **2026-02-05** (v1) `f9c417ec1ed4`: 2 info - added the new optional request property `payment_methods_config` - added the optional property `payment_methods_config` to the response with the `201` status - **2026-01-21** (v1) `9fba45d198be`: 2 info - api tag `Subscriptions` added - api tag `Subscription` removed - **2026-01-20** (v1) `665f680338b5`: 2 info - api tag `Subscription` added - api tag `subscription` removed - **2025-12-17** (v1) `2244ec0dabe3`: 6 breaking, 22 info - removed `subschema #1, subschema #2` from the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property `oneOf` list - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` from the `price_components/extra_components/items/component/fee` request property `oneOf` list - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` from the `price_components/overridden_components/items/component/fee` request property `oneOf` list - added `#/components/schemas/PercentageDiscount, #/components/schemas/FixedDiscount` to the `applied_coupons/items/coupon/discount` response property `oneOf` list for the response status `201` - added `#/components/schemas/RateFee, #/components/schemas/OneTimeFee, #/components/schemas/RecurringFee, #/components/schemas/CapacityFee, #/components/schemas/SlotFee, #/components/schemas/UsageFee` to the `add_ons/items/fee` response property `oneOf` list for the response status `201` - added `#/components/schemas/RateFee, #/components/schemas/OneTimeFee, #/components/schemas/RecurringFee, #/components/schemas/CapacityFee, #/components/schemas/SlotFee, #/components/schemas/UsageFee` to the `components/items/fee` response property `oneOf` list for the response status `201` - added discriminator to `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property - added discriminator to `price_components/extra_components/items/component/fee` request property - added discriminator to `price_components/overridden_components/items/component/fee` request property - added `#/components/schemas/RateFee, #/components/schemas/OneTimeFee, #/components/schemas/RecurringFee, #/components/schemas/CapacityFee, #/components/schemas/SlotFee, #/components/schemas/UsageFee` to the `price_components/extra_components/items/component/fee` request property `oneOf` list - added `#/components/schemas/RateFee, #/components/schemas/OneTimeFee, #/components/schemas/RecurringFee, #/components/schemas/CapacityFee, #/components/schemas/SlotFee, #/components/schemas/UsageFee` to the `price_components/overridden_components/items/component/fee` request property `oneOf` list - added `#/components/schemas/SubscriptionAddOnOverride, #/components/schemas/SubscriptionAddOnParameterization` to the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property `oneOf` list - added the optional property `activated_at` to the response with the `201` status - added the optional property `billing_start_date` to the response with the `201` status - added the optional property `end_date` to the response with the `201` status - added the optional property `invoice_memo` to the response with the `201` status - added the optional property `trial_duration` to the response with the `201` status - added discriminator to `add_ons/items/fee` response property for the response status `201` - added discriminator to `applied_coupons/items/coupon/discount` response property for the response status `201` - added discriminator to `components/items/fee` response property for the response status `201` - removed `subschema #1, subschema #2` from the `applied_coupons/items/coupon/discount` response property `oneOf` list for the response status `201` - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` from the `add_ons/items/fee` response property `oneOf` list for the response status `201` - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` from the `components/items/fee` response property `oneOf` list for the response status `201` - added the required property `created_at` to the response with the `201` status - added the required property `mrr_cents` to the response with the `201` status - added the required property `net_terms` to the response with the `201` status - added the required property `period` to the response with the `201` status - added the required property `start_date` to the response with the `201` status - **2025-12-02** (v1) `f3aab0fcd63f`: 1 warning - added the new `ERRORED` enum value to the `status` response property for the response status `201` - **2025-10-17** (v1) `b03a38c9dbd4`: 1 breaking, 2 warning, 4 info - removed `subschema #1, subschema #2` from the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property `oneOf` list - added the new `SEMIANNUAL` enum value to the `add_ons/items/period` response property for the response status `201` - added the new `SEMIANNUAL` enum value to the `components/items/period` response property for the response status `201` - added the new `SEMIANNUAL` enum value to the request property `price_components/extra_components/items/component/period` - added the new `SEMIANNUAL` enum value to the request property `price_components/overridden_components/items/component/period` - added the new `SEMIANNUAL` enum value to the request property `price_components/parameterized_components/items/parameters/billing_period/oneOf[#/components/schemas/BillingPeriodEnum]/` - added `subschema #1, subschema #2` to the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property `oneOf` list - **2025-10-16** (v1) `a174f46ee4f8`: 4 info - added the new optional request property `auto_advance_invoices` - added the new optional request property `charge_automatically` - added the required property `auto_advance_invoices` to the response with the `201` status - added the required property `charge_automatically` to the response with the `201` status - **2025-10-14** (v1) `532c5edf3ddd`: 9 breaking, 2 warning, 9 info - added the new required request property `plan_id` - the request property `add_ons` became not nullable - the request property `coupon_codes` became not nullable - the request property `end_date` became not nullable - the request property `invoice_memo` became not nullable - the request property `net_terms` became not nullable - the request property `trial_days` became not nullable - removed `#/components/schemas/CreateSubscriptionComponents, subschema #1` from the `price_components` request property `oneOf` list - the `price_components` request property type changed from no type to `object` - removed the request property `invoice_threshold` - removed the request property `plan_version_id` - added the new optional request property `price_components/extra_components` - added the new optional request property `price_components/overridden_components` - added the new optional request property `price_components/parameterized_components` - added the new optional request property `price_components/remove_components` - added the new optional request property `version` - added the optional property `checkout_url` to the response with the `201` status - added the required property `add_ons` to the response with the `201` status - added the required property `applied_coupons` to the response with the `201` status - added the required property `components` to the response with the `201` status - **2025-10-14** (v1) `da72c03d9734`: 2 info - added the new optional request property `purchase_order` - added the optional property `purchase_order` to the response with the `201` status - **2025-07-23** (v1) `cad632d024ce`: 6 breaking, 6 info - removed the enum value `ONETIME` of the request property `price_components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/component/period` - removed the enum value `ONETIME` of the request property `price_components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/component/period` - removed `#/components/schemas/BillingPeriod` from the `price_components/oneOf[#/components/schemas/CreateSubscriptionComponents]/parameterized_components/items/parameters/billing_period` request property `oneOf` list - removed `subschema #1, subschema #2` from the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property `oneOf` list - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` from the `price_components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/component/fee` request property `oneOf` list - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` from the `price_components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/component/fee` request property `oneOf` list - added the new `ONE_TIME` enum value to the request property `price_components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/component/period` - added the new `ONE_TIME` enum value to the request property `price_components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/component/period` - added `#/components/schemas/BillingPeriodEnum` to the `price_components/oneOf[#/components/schemas/CreateSubscriptionComponents]/parameterized_components/items/parameters/billing_period` request property `oneOf` list - added `subschema #1, subschema #2` to the `add_ons/items/customization/oneOf[#/components/schemas/SubscriptionAddOnCustomization]/` request property `oneOf` list - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` to the `price_components/oneOf[#/components/schemas/CreateSubscriptionComponents]/extra_components/items/component/fee` request property `oneOf` list - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` to the `price_components/oneOf[#/components/schemas/CreateSubscriptionComponents]/overridden_components/items/component/fee` request property `oneOf` list - **2025-07-22** (v1) `f9622bc2c669`: 1 info - endpoint added - **2025-07-09** (v1) `dece17f86f99`: 1 breaking - api removed without deprecation --- [Operation](https://skmtc.dev/meteroid-oss/apis/meteroid/docs/api/v1/subscriptions/post.md) - [API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) - [Page](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/subscriptions/post)