--- title: "Changes to Create checkout session" method: POST path: "/checkout/sessions" --- # Changes to Create checkout session `POST /checkout/sessions` > Every recorded change to this operation, newest first. ## Timeline Changed in 29 of 139 revisions. - **2026-10-17** `3feab3c86d9d`: 2 info - **2026-10-14** `c68a971ce7b5`: 1 info - **2026-10-12** `9b1ab5a75b5e`: 2 info - **2026-10-12** `d663503436ad`: 2 warning - **2026-10-10** `dbd15795e0ad`: 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-24** `19bac1b92501`: 2 info - **2026-09-21** `15dcbc3c880b`: 2 info - **2026-09-21** `56ac1e6adeb7`: 2 warning - **2026-09-21** `0aa0bf7c01e1`: 3 info - **2026-09-21** `c730635dc27e`: 1 warning - **2026-09-21** `ca8fb37253e5`: 1 info - **2026-09-19** `ee9cc26d2500`: 1 warning - **2026-09-18** `0fb60b40c570`: 1 info - **2026-09-11** `614c3fd4a9b1`: 1 warning, 2 info - **2026-09-09** `ac5fdb062f59`: 9 warning, 4 info - **2026-09-03** `e36fe54e0efb`: 2 warning, 2 info - **2026-09-02** `87ce400e15de`: 1 warning, 3 info - **2026-08-14** `29f14678f58f`: 1 warning, 5 info - **2026-07-31** `50b7421a9690`: 2 warning, 6 info - **2026-07-15** `f8ecf435d25d`: 3 warning, 2 info - **2026-07-09** `646d6658479b`: 2 breaking - **2026-07-09** `7d57386313c7`: 14 breaking, 10 warning, 17 info - **2026-07-09** `4b1a811c4179`: 20 breaking, 15 warning, 10 info - **2026-06-29** `7857ddc6e44d`: 2 breaking, 3 warning, 7 info - **2026-06-26** `0b54d0a8a98f`: 3 breaking, 10 warning, 3 info - **2026-06-24** `08e2dac200bb`: 1 info ## Changes - **2026-10-17** `3feab3c86d9d`: 2 info - added the new optional request property `configuration/modify_subscription_params/trial_end_at` - added the new `trial_end` enum value to the request property `configuration/modify_subscription_params/modify_type` - **2026-10-14** `c68a971ce7b5`: 1 info - added the new optional request property `configuration/add_addon_batch_params` - **2026-10-12** `9b1ab5a75b5e`: 2 info - added the new optional request property `configuration/add_addon_params/addons/items/coupons` - added the new optional request property `configuration/modify_subscription_params/line_item_modifications/items/coupons` - **2026-10-12** `d663503436ad`: 2 warning - removed the request property `configuration/add_addon_params/addons/items/coupons` - removed the request property `configuration/modify_subscription_params/line_item_modifications/items/coupons` - **2026-10-10** `dbd15795e0ad`: 2 info - added the new optional request property `configuration/add_addon_params/addons/items/coupons` - added the new optional request property `configuration/modify_subscription_params/line_item_modifications/items/coupons` - **2026-09-28** `91efded425ee`: 1 warning, 1 info - added the new `stripe` enum value to the `payment_provider` response property for the response status `201` - added the new `stripe` enum value to the request property `payment_provider` - **2026-09-28** `fa71deaf653b`: 1 breaking, 1 info - removed the enum value `stripe` of the request property `payment_provider` - removed the `stripe` enum value from the `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 `payment_provider` response property for the response status `201` - added the new `stripe` enum value to the request property `payment_provider` - **2026-09-24** `19bac1b92501`: 2 info - added the new optional request property `configuration/modify_subscription_params/line_item_modifications/items/amount` - added the new optional request property `configuration/modify_subscription_params/modify_type` - **2026-09-21** `15dcbc3c880b`: 2 info - added the new optional request property `entity_creation_options` - added the optional property `entity_creation_result` to the response with the `201` status - **2026-09-21** `56ac1e6adeb7`: 2 warning - removed the request property `entity_creation_options` - removed the optional property `entity_creation_result` from the response with the `201` status - **2026-09-21** `0aa0bf7c01e1`: 3 info - added the new optional request property `configuration/add_addon_params/removes` - added the new optional request property `entity_creation_options` - added the optional property `entity_creation_result` to the response with the `201` status - **2026-09-21** `c730635dc27e`: 1 warning - removed the request property `configuration/add_addon_params/removes` - **2026-09-21** `ca8fb37253e5`: 1 info - added the new optional request property `configuration/add_addon_params/removes` - **2026-09-19** `ee9cc26d2500`: 1 warning - removed the request property `configuration/add_addon_params/removes` - **2026-09-18** `0fb60b40c570`: 1 info - added the new optional request property `configuration/add_addon_params/removes` - **2026-09-11** `614c3fd4a9b1`: 1 warning, 2 info - added the new `pay_invoice` enum value to the `action` response property for the response status `201` - added the new optional request property `configuration/pay_invoice_params` - added the new `pay_invoice` enum value to the request property `action` - **2026-09-09** `ac5fdb062f59`: 9 warning, 4 info - removed the optional property `configuration` from the response with the `201` status - removed the optional property `created_by` from the response with the `201` status - removed the optional property `environment_id` from the response with the `201` status - removed the optional property `payment_provider_config` from the response with the `201` status - removed the optional property `provider_result` from the response with the `201` status - removed the optional property `result` from the response with the `201` status - removed the optional property `status` from the response with the `201` status - removed the optional property `tenant_id` from the response with the `201` status - removed the optional property `updated_by` from the response with the `201` status - added the optional property `next_poll_after_ms` to the response with the `201` status - added the optional property `payment` to the response with the `201` status - added the optional property `stale` to the response with the `201` status - added the optional property `terminal` to the response with the `201` status - **2026-09-03** `e36fe54e0efb`: 2 warning, 2 info - removed the request property `payment_provider_config/customer_present` - removed the optional property `payment_provider_config/customer_present` from the response with the `201` status - added the new optional request property `payment_provider_config/customer_not_present` - added the optional property `payment_provider_config/customer_not_present` to the response with the `201` status - **2026-09-02** `87ce400e15de`: 1 warning, 3 info - added the new `chargebee` enum value to the `payment_provider` response property for the response status `201` - added the new optional request property `payment_provider_config/customer_present` - added the new `chargebee` enum value to the request property `payment_provider` - added the optional property `payment_provider_config/customer_present` to the response with the `201` status - **2026-08-14** `29f14678f58f`: 1 warning, 5 info - added the new `add_addon` enum value to the `action` response property for the response status `201` - added the new optional request property `configuration/add_addon_params` - added the new optional request property `configuration/create_subscription_params/subscription_id` - added the new `add_addon` enum value to the request property `action` - added the optional property `configuration/add_addon_params` to the response with the `201` status - added the optional property `configuration/create_subscription_params/subscription_id` to the response with the `201` status - **2026-07-31** `50b7421a9690`: 2 warning, 6 info - added the new `modify_subscription` enum value to the `action` response property for the response status `201` - added the new `wallet_topup` enum value to the `action` response property for the response status `201` - added the new optional request property `configuration/modify_subscription_params` - added the new optional request property `configuration/wallet_topup_params` - added the new `modify_subscription` enum value to the request property `action` - added the new `wallet_topup` enum value to the request property `action` - added the optional property `configuration/modify_subscription_params` to the response with the `201` status - added the optional property `configuration/wallet_topup_params` to the response with the `201` status - **2026-07-15** `f8ecf435d25d`: 3 warning, 2 info - 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 `409` - added the new `not_implemented` enum value to the `code` response property for the response status `500` - added the new optional request property `payment_provider_config` - added the optional property `payment_provider_config` to the response with the `201` status - **2026-07-09** `646d6658479b`: 2 breaking - the `configuration/create_subscription_params/end_date` request property format changed from no format to `date-time` - the `configuration/create_subscription_params/start_date` request property format changed from no format to `date-time` - **2026-07-09** `7d57386313c7`: 14 breaking, 10 warning, 17 info - request property `action` was restricted to a list of enum values - request property `payment_provider` was restricted to a list of enum values - the `action` request property type changed from no type to `string` - the `configuration` request property type changed from no type to `object` - the `payment_provider` request property type changed from no type to `string` - the `action` response's property type changed from no type to `string` for status `201` - the `checkout_status` response's property type changed from no type to `string` for status `201` - the `configuration/create_subscription_params` response's property type changed from no type to `object` for status `201` - the `metadata` response's property type changed from no type to `object` for status `201` - the `payment_action` response's property type changed from no type to `object` for status `201` - the `payment_provider` response's property type changed from no type to `string` for status `201` - the `provider_result/next_action` response's property type changed from no type to `object` for status `201` - the `result/create_subscription_result` response's property type changed from no type to `object` for status `201` - the `status` response's property type changed from no type to `string` for status `201` - added the new `archived` enum value to the `status` response property for the response status `201` - added the new `completed` enum value to the `checkout_status` response property for the response status `201` - added the new `create_subscription` enum value to the `action` response property for the response status `201` - added the new `deleted` enum value to the `status` response property for the response status `201` - added the new `expired` enum value to the `checkout_status` response property for the response status `201` - added the new `failed` enum value to the `checkout_status` response property for the response status `201` - added the new `initiated` enum value to the `checkout_status` response property for the response status `201` - added the new `pending` enum value to the `checkout_status` response property for the response status `201` - added the new `published` enum value to the `status` response property for the response status `201` - added the new `razorpay` enum value to the `payment_provider` response property for the response status `201` - added the new optional request property `configuration/create_subscription_params` - added the new `create_subscription` enum value to the request property `action` - added the new `razorpay` enum value to the request property `payment_provider` - added the optional property `configuration/create_subscription_params/billing_period` to the response with the `201` status - added the optional property `configuration/create_subscription_params/currency` to the response with the `201` status - added the optional property `configuration/create_subscription_params/end_date` to the response with the `201` status - added the optional property `configuration/create_subscription_params/lookup_key` to the response with the `201` status - added the optional property `configuration/create_subscription_params/metadata` to the response with the `201` status - added the optional property `configuration/create_subscription_params/plan_id` to the response with the `201` status - added the optional property `configuration/create_subscription_params/start_date` to the response with the `201` status - added the optional property `payment_action/type` to the response with the `201` status - added the optional property `payment_action/url` to the response with the `201` status - added the optional property `provider_result/next_action/type` to the response with the `201` status - added the optional property `provider_result/next_action/url` to the response with the `201` status - added the optional property `result/create_subscription_result/invoice_id` to the response with the `201` status - added the optional property `result/create_subscription_result/payment_id` to the response with the `201` status - …1 more - **2026-07-09** `4b1a811c4179`: 20 breaking, 15 warning, 10 info - removed the enum value `create_subscription` of the request property `action` - removed the enum value `razorpay` of the request property `payment_provider` - the `action` request property type changed from `string` to no type - the `configuration` request property type changed from `object` to no type - the `payment_provider` request property type changed from `string` to no type - the `action` response's property type changed from `string` to no type for status `201` - the `cancelled_at` response's property format changed from `date-time` to no format for status `201` - the `checkout_status` response's property type changed from `string` to no type for status `201` - the `completed_at` response's property format changed from `date-time` to no format for status `201` - the `configuration/create_subscription_params` response's property type changed from `object` to no type for status `201` - the `created_at` response's property format changed from `date-time` to no format for status `201` - the `expires_at` response's property format changed from `date-time` to no format for status `201` - the `metadata` response's property type changed from `object` to no type for status `201` - the `payment_action` response's property type changed from `object` to no type for status `201` - the `payment_provider` response's property type changed from `string` to no type for status `201` - the `provider_result/expires_at` response's property format changed from `date-time` to no format for status `201` - the `provider_result/next_action` response's property type changed from `object` to no type for status `201` - the `result/create_subscription_result` response's property type changed from `object` to no type for status `201` - the `status` response's property type changed from `string` to no type for status `201` - the `updated_at` response's property format changed from `date-time` to no format for status `201` - removed the request property `configuration/create_subscription_params` - removed the optional property `configuration/create_subscription_params/billing_period` from the response with the `201` status - removed the optional property `configuration/create_subscription_params/currency` from the response with the `201` status - removed the optional property `configuration/create_subscription_params/end_date` from the response with the `201` status - removed the optional property `configuration/create_subscription_params/lookup_key` from the response with the `201` status - removed the optional property `configuration/create_subscription_params/metadata` from the response with the `201` status - removed the optional property `configuration/create_subscription_params/plan_id` from the response with the `201` status - removed the optional property `configuration/create_subscription_params/start_date` from the response with the `201` status - removed the optional property `payment_action/type` from the response with the `201` status - removed the optional property `payment_action/url` from the response with the `201` status - removed the optional property `provider_result/next_action/type` from the response with the `201` status - removed the optional property `provider_result/next_action/url` from the response with the `201` status - removed the optional property `result/create_subscription_result/invoice_id` from the response with the `201` status - removed the optional property `result/create_subscription_result/payment_id` from the response with the `201` status - removed the optional property `result/create_subscription_result/subscription_id` from the response with the `201` status - removed the `archived` enum value from the `status` response property for the response status `201` - removed the `completed` enum value from the `checkout_status` response property for the response status `201` - removed the `create_subscription` enum value from the `action` response property for the response status `201` - removed the `deleted` enum value from the `status` response property for the response status `201` - removed the `expired` enum value from the `checkout_status` response property for the response status `201` - …5 more - **2026-06-29** `7857ddc6e44d`: 2 breaking, 3 warning, 7 info - added the new required request property `customer_external_id` - removed the enum value `stripe` of the request property `payment_provider` - removed the request property `customer_id` - removed the optional property `provider_result/create_subscription_result` from the response with the `201` status - added the new `razorpay` enum value to the `payment_provider` response property for the response status `201` - added the new `razorpay` enum value to the request property `payment_provider` - added the optional property `provider_result/expires_at` to the response with the `201` status - added the optional property `provider_result/next_action` to the response with the `201` status - added the optional property `provider_result/provider_metadata` to the response with the `201` status - added the optional property `provider_result/provider_payment_intent_id` to the response with the `201` status - added the optional property `provider_result/provider_session_id` to the response with the `201` status - removed the `stripe` enum value from the `payment_provider` response property for the response status `201` - **2026-06-26** `0b54d0a8a98f`: 3 breaking, 10 warning, 3 info - the response property `configuration/create_subscription_params/billing_period` became optional for the status `201` - the response property `configuration/create_subscription_params/currency` became optional for the status `201` - the response property `configuration/create_subscription_params/plan_id` became optional for the status `201` - removed the request property `configuration/create_subscription_params/billing_cycle` - removed the request property `configuration/create_subscription_params/billing_period_count` - removed the request property `configuration/create_subscription_params/credit_grants` - removed the request property `configuration/create_subscription_params/line_items` - removed the request property `configuration/create_subscription_params/subscription_coupons` - removed the optional property `configuration/create_subscription_params/billing_cycle` from the response with the `201` status - removed the optional property `configuration/create_subscription_params/billing_period_count` from the response with the `201` status - removed the optional property `configuration/create_subscription_params/credit_grants` from the response with the `201` status - removed the optional property `configuration/create_subscription_params/line_items` from the response with the `201` status - removed the optional property `configuration/create_subscription_params/subscription_coupons` from the response with the `201` status - the request property `configuration/create_subscription_params/billing_period` became optional - the request property `configuration/create_subscription_params/currency` became optional - the request property `configuration/create_subscription_params/plan_id` became optional - **2026-06-24** `08e2dac200bb`: 1 info - endpoint added --- [Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/checkout/sessions/post.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/checkout/sessions/post)