---
title: "Changes to Create a Subscription Plan"
method: POST
path: "/subscription_plans"
---

# Changes to Create a Subscription Plan

`POST /subscription_plans`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 27 revisions.

- **2026-09-05** `1d6b546b10f2`: 1 info
- **2026-09-02** `156f17ff484d`: 1 breaking, 13 warning, 1 info
- **2026-08-25** `9db82db717c5`: 2 breaking, 1 info
- **2026-08-22** `7919e33b4853`: 1 breaking, 1 info

## Changes

- **2026-09-05** `1d6b546b10f2`: 1 info
  - added the optional property `billing_items` to the response with the `201` status
- **2026-09-02** `156f17ff484d`: 1 breaking, 13 warning, 1 info
  - the request's body type changed from `object` to no type
  - removed the request property `amount`
  - removed the request property `billing_defaults`
  - removed the request property `billing_interval`
  - removed the request property `currency`
  - removed the request property `default_total_billing_intervals`
  - removed the request property `description`
  - removed the request property `discount_phase_defaults`
  - removed the request property `linked_to`
  - removed the request property `linked_type`
  - removed the request property `nickname`
  - removed the request property `plan_name`
  - removed the request property `tags`
  - removed the request property `trial_defaults`
  - added `#/components/schemas/createSubscriptionPlan, #/components/schemas/createSubscriptionPlanDefaultDuration, #/components/schemas/createSubscriptionPlanDiscountPhase, #/components/schemas/createSubscriptionPlanTrialPhase` to the request body `anyOf` list
- **2026-08-25** `9db82db717c5`: 2 breaking, 1 info
  - the response property `discount_phase_defaults` became nullable for the status `201`
  - the response property `trial_defaults` became nullable for the status `201`
  - added the optional property `is_usage_based` to the response with the `201` status
- **2026-08-22** `7919e33b4853`: 1 breaking, 1 info
  - the response property `nickname` became nullable for the status `201`
  - the request property `nickname` became nullable

---

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