v1
latestOpenAPI 3.1.02026-07-2684271522.2 KBPrices
Create Price
Creates a new price. Supply product to attach the price to an existing product, or product_data to create a new product inline in the same request. A price is one-time unless you include recurring, in which case it bills on the given interval. Amounts are in the smallest currency unit (cents) and charged in USD. If HSA/FSA eligibility is not set on the price, the parent product's eligibility applies.
post/v1/prices
Request body
Example request
{
"price": {
"product": "fprod_01J9XR8M3K7VZ8N2YB4WJ6T0RA"
}
}Response
An envelope wrapping a single price object.
Example response
{
"price": {
"price_id": "fprice_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"owner_partner_id": "facct_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"description": "Premium SPF 50 mineral sunscreen",
"unit_amount": 0,
"recurring": {},
"active": false,
"product": "fprod_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"created_at": "2026-06-15T14:30:00Z",
"type": "one_time",
"metadata": {
"order_id": "8842",
"channel": "shopify"
},
"hsa_fsa_eligibility": "not_eligible",
"test_mode": false
}
}