Sign in

v4

latestOpenAPI 3.1.0MIT2026-08-02128224900.7 KB
Prices

Create Price

Create a new price

post/prices

Request body

amountinteger nullable

The price amount in the smallest currency unit (e.g. cents).

cadence'year' | 'month' | 'one-time' | 'email' | 'week' required

The billing cadence for this price.

currencystring required

The three-letter ISO currency code (e.g. 'usd').

descriptionstring nullable

An optional human-readable description of the price.

maximum_amountinteger nullable

The maximum amount for pay-what-you-want prices.

minimum_amountinteger nullable

The minimum amount for pay-what-you-want prices.

product_idstring nullable

The ID of the Stripe product this price belongs to.

style'pay-what-you-want' | 'fixed' | 'usage-based' required

The pricing style: 'fixed', 'pay-what-you-want', or 'usage-based'.

suggested_amountinteger nullable

The suggested amount for pay-what-you-want prices.

Response

Created

amountinteger nullable

The price amount in the smallest currency unit (e.g. cents).

cadence'year' | 'month' | 'one-time' | 'email' | 'week' required

The billing cadence for this price.

currencystring required

The three-letter ISO currency code (e.g. 'usd').

descriptionstring nullable

An optional human-readable description of the price.

maximum_amountinteger nullable

The maximum amount for pay-what-you-want prices.

minimum_amountinteger nullable

The minimum amount for pay-what-you-want prices.

product_idstring nullable

The ID of the Stripe product this price belongs to.

style'pay-what-you-want' | 'fixed' | 'usage-based' required

The pricing style: 'fixed', 'pay-what-you-want', or 'usage-based'.

suggested_amountinteger nullable

The suggested amount for pay-what-you-want prices.

idstring required

The unique identifier of the price.