---
title: "Changes to Create a custom billing price"
method: POST
path: "/billing/prices"
---

# Changes to Create a custom billing price

`POST /billing/prices`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 49 revisions.

- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 2 info
- **2026-03-19** (2025-11-10) `b1a5498e4465`: 12 breaking, 4 info
- **2026-02-21** (2025-11-10) `6b6bf4e8c298`: 1 info
- **2026-02-02** (2025-11-10) `9bb3dbe7391a`: 1 info

## Changes

- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 2 info
  - added the new optional request property `supported_billing_periods`
  - added the required property `supported_billing_periods` to the response with the `200` status
- **2026-03-19** (2025-11-10) `b1a5498e4465`: 12 breaking, 4 info
  - the response property `annual_monthly_fee` became nullable for the status `200`
  - the response property `fee` became nullable for the status `200`
  - the `annual_monthly_fee` response's property type changed from `object` to no type for status `200`
  - the `fee` response's property type changed from `object` to no type for status `200`
  - removed the required property `annual_monthly_fee/amount` from the response with the `200` status
  - removed the required property `annual_monthly_fee/amount_formatted` from the response with the `200` status
  - removed the required property `annual_monthly_fee/currency` from the response with the `200` status
  - removed the required property `annual_monthly_fee/currency_symbol` from the response with the `200` status
  - removed the required property `fee/amount` from the response with the `200` status
  - removed the required property `fee/amount_formatted` from the response with the `200` status
  - removed the required property `fee/currency` from the response with the `200` status
  - removed the required property `fee/currency_symbol` from the response with the `200` status
  - the request property `amount` became nullable
  - the request property `annual_monthly_amount` became nullable
  - added `#/components/schemas/CommerceMoneyResponse` to the `annual_monthly_fee` response property `allOf` list for the response status `200`
  - added `#/components/schemas/CommerceMoneyResponse` to the `fee` response property `allOf` list for the response status `200`
- **2026-02-21** (2025-11-10) `6b6bf4e8c298`: 1 info
  - added the required property `is_default` to the response with the `200` status
- **2026-02-02** (2025-11-10) `9bb3dbe7391a`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/clerk/apis/clerk-backend-api/docs/billing/prices/post.md) - [API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [Page](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/billing/prices/post)