Skip to main content
POST
Add a price to a version

Authorizations

Authorization
string
header
required

Your account's secret key: Authorization: Bearer sk_test_… or sk_live_…. Server-side only.

Headers

Idempotency-Key
string

A unique key per operation (a UUID works). Retrying with the same key returns the original response.

Path Parameters

productID
string<uuid>
required

Product ID.

versionID
string<uuid>
required

Product version ID.

Body

application/json
meterId
string<uuid>
required

The meter this price rates, on the same product. Required: a fixed recurring amount is not a price, it is the version's basePrice.

model
enum<string>
required

flat, per_unit, tiered, volume or package.

Available options:
flat,
per_unit,
tiered,
volume,
package
unitAmount
string | null

Amount per unit as a decimal string.

tiers
any
default:[]

Price tiers for tiered, volume and package.

currency
string

Optional; defaults to the product's currency.

Example:

"BRL"

Response

Price created.

A meter's price on a version.

id
string<uuid>
productVersionId
string<uuid>
meterId
string<uuid> | null

The meter this price rates.

model
enum<string>

flat, per_unit, tiered (graduated), volume or package.

Available options:
flat,
per_unit,
tiered,
volume,
package
unitAmount
string | null

Amount per unit as a decimal string; sub-cent values allowed.

tiers
object[]

Price tiers for tiered, volume and package.

currency
string