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

# Changes to Create a price

`POST /prices`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 19 revisions.

- **2026-10-19** (v1) `4f35a8c6ea4d`: 2 breaking, 2 info
- **2026-07-09** (v1) `e1ac347eb3c5`: 4 warning, 8 info
- **2026-02-02** (v1) `9ba8be0f2006`: 53 breaking, 7 warning, 60 info
- **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 2 info
- **2025-03-07** (v1) `a3359d7731fd`: 9 breaking, 7 info
- **2024-12-06** (v1) `274e5b2be190`: 232 breaking, 2 warning, 232 info
- **2024-05-14** (v1) `61fe84bfd516`: 4 breaking, 6 info
- **2024-02-19** (v1) `a4a4068ff792`: 7 breaking, 1 warning, 5 info

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 2 breaking, 2 info
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/CountryCodeNonSupported` to the `trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `unit_price_overrides/items/country_codes/items/` request property `oneOf` list
- **2026-07-09** (v1) `e1ac347eb3c5`: 4 warning, 8 info
  - added the new `CLP` enum value to the `data/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `201`
  - added the new `CLP` enum value to the `data/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `201`
  - added the new `PEN` enum value to the `data/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `201`
  - added the new `PEN` enum value to the `data/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `201`
  - added the new optional request property `trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price`
  - added the new optional request property `trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides`
  - added the new `CLP` enum value to the request property `unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the optional property `data/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price` to the response with the `201` status
  - added the optional property `data/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides` to the response with the `201` status
- **2026-02-02** (v1) `9ba8be0f2006`: 53 breaking, 7 warning, 60 info
  - request body became required
  - added `#/components/schemas/CatalogType` to the `type` request property `allOf` list
  - added `#/components/schemas/Money` to the `unit_price` request property `allOf` list
  - added `#/components/schemas/Money` to the `unit_price_overrides/items/unit_price` request property `allOf` list
  - added `#/components/schemas/PriceId` to the `id` request property `allOf` list
  - added `#/components/schemas/PriceQuantity` to the `quantity` request property `allOf` list
  - added `#/components/schemas/ProductId` to the `product_id` request property `allOf` list
  - added `#/components/schemas/TaxMode` to the `tax_mode` request property `allOf` list
  - the request property `name` became not nullable
  - removed the enum value `account_setting` of the request property `tax_mode`
  - removed the enum value `custom` of the request property `type`
  - removed the enum value `external` of the request property `tax_mode`
  - removed the enum value `internal` of the request property `tax_mode`
  - removed the enum value `standard` of the request property `type`
  - removed `#/components/schemas/country_code_supported` from the `unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - removed `#/components/schemas/custom_data, subschema #2` from the `custom_data` request property `oneOf` list
  - removed `#/components/schemas/duration, subschema #2` from the `billing_cycle` request property `oneOf` list
  - removed `#/components/schemas/import_meta, subschema #2` from the `import_meta` request property `oneOf` list
  - removed `#/components/schemas/price_trial_duration, subschema #2` from the `trial_period` request property `oneOf` list
  - added the pattern `.*\S.*` to the request property `description`
  - the `id` request property type changed from `string` to no type
  - the `name` request property type changed from `string, null` to no type
  - the `product_id` request property type changed from `string` to no type
  - the `quantity` request property type changed from `object` to no type
  - the `tax_mode` request property type changed from `string` to no type
  - the `type` request property type changed from `string` to no type
  - the `unit_price` request property type changed from `object` to no type
  - the `unit_price_overrides/items/unit_price` request property type changed from `object` to no type
  - the `data/name` response property's maxLength was unset from `150` for the response status `201`
  - the `data/name` response property's minLength was decreased from `1` to `0` for the response status `201`
  - added `#/components/schemas/CountryCodeSupported` to the `data/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `201`
  - the `data/created_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `201`
  - the `data/id` response's property type changed from `string` to no type for status `201`
  - the `data/name` response's property type changed from `string, null` to no type for status `201`
  - the `data/product_id` response's property type changed from `string` to no type for status `201`
  - the `data/quantity` response's property type changed from `object` to no type for status `201`
  - the `data/status` response's property type changed from `string` to no type for status `201`
  - the `data/tax_mode` response's property type changed from `string` to no type for status `201`
  - the `data/type` response's property type changed from `string` to no type for status `201`
  - the `data/unit_price` response's property type changed from `object` to no type for status `201`
  - …80 more
- **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 2 info
  - the `data/description` response property's maxLength was increased from `200` to `500` for the response status `201`
  - the `data/name` response property's maxLength was increased from `50` to `150` for the response status `201`
  - the `description` request property's maxLength was increased from `200` to `500`
  - the `name` request property's maxLength was increased from `50` to `150`
- **2025-03-07** (v1) `a3359d7731fd`: 9 breaking, 7 info
  - the request property `import_meta/oneOf[subschema #1: ImportMeta]/external_id` became not nullable
  - removed `#/components/schemas/duration` from the `trial_period` request property `oneOf` list
  - the `import_meta/oneOf[subschema #1: ImportMeta]/external_id` request property type changed from `string, null` to no type
  - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `201`
  - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `201`
  - added `#/components/schemas/external_id, subschema #2` to the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/migration_provider_public` to the `data/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/price_trial_duration` to the `data/trial_period` response property `oneOf` list for the response status `201`
  - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `201`
  - the `import_meta/oneOf[subschema #1: ImportMeta]/external_id` request property's minLength was decreased from `1` to `0`
  - added `#/components/schemas/external_id, subschema #2` to the `import_meta/oneOf[subschema #1: ImportMeta]/external_id` request property `oneOf` list
  - added `#/components/schemas/migration_provider_public` to the `import_meta/oneOf[subschema #1: ImportMeta]/imported_from` request property `oneOf` list
  - added `#/components/schemas/price_trial_duration` to the `trial_period` request property `oneOf` list
  - the request required property `import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only
  - removed `#/components/schemas/duration` from the `data/trial_period` response property `oneOf` list for the response status `201`
  - the response required property `data/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `201`
- **2024-12-06** (v1) `274e5b2be190`: 232 breaking, 2 warning, 232 info
  - removed the enum value `AD` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AE` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AG` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AI` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AL` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AM` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AO` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AR` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AS` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AT` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AU` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AW` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AX` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AZ` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BA` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BB` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BD` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BE` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BF` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BG` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BH` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BI` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BJ` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BL` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BM` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BN` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BO` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BQ` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BR` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BS` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BT` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BV` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BW` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BZ` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CA` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CC` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CG` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CH` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CI` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CK` of the request property `unit_price_overrides/items/country_codes/items/`
  - …426 more
- **2024-05-14** (v1) `61fe84bfd516`: 4 breaking, 6 info
  - removed `#/components/schemas/period` from the `billing_cycle` request property `oneOf` list
  - removed `#/components/schemas/period` from the `trial_period` request property `oneOf` list
  - added `#/components/schemas/duration` to the `data/billing_cycle` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/duration` to the `data/trial_period` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/duration` to the `billing_cycle` request property `oneOf` list
  - added `#/components/schemas/duration` to the `trial_period` request property `oneOf` list
  - added the optional property `data/created_at` to the response with the `201` status
  - added the optional property `data/updated_at` to the response with the `201` status
  - removed `#/components/schemas/period` from the `data/billing_cycle` response property `oneOf` list for the response status `201`
  - removed `#/components/schemas/period` from the `data/trial_period` response property `oneOf` list for the response status `201`
- **2024-02-19** (v1) `a4a4068ff792`: 7 breaking, 1 warning, 5 info
  - the request property `custom_data` became not nullable
  - the `custom_data` request property type changed from `object, null` to no type
  - added `#/components/schemas/custom_data, subschema #2` to the `data/custom_data` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/import_meta, subschema #2` to the `data/import_meta` response property `oneOf` list for the response status `201`
  - the `data/custom_data` response's property type changed from `object, null` to no type for status `201`
  - the `data/import_meta` response's property type changed from `object, null` to no type for status `201`
  - removed the required property `data/import_meta/imported_from` from the response with the `201` status
  - removed the optional property `data/import_meta/external_id` from the response with the `201` status
  - added `#/components/schemas/custom_data, subschema #2` to the `custom_data` request property `oneOf` list
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `500`
  - the `status` response's property default value `active` was added for the status `201`

---

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