Create a price
Body·
Fields accepted when creating a price. Unknown or read-only fields are rejected.
- Type: string | nullFormat: uuidproduct
_id requiredReferences products.id.
- Type: "per_unit" or "tiered" or nullenumbilling
_scheme per_unit: quantity × unit_amount. tiered: the tiers decide, in tiers_mode.
- Type: string | nullcurrency
ISO 4217, lowercase.
- Type: string | nullFormat: uuidensemble
_id The ensemble this price is for, when the product’s price depends on who plays it. Empty: the product’s price for any ensemble. References ensembles.id.
- Type: string | nulllabel
Internal nickname, e.g. "10-piece, 2027".
- Type: string | nulllookup
_key A stable handle, unique per band, e.g. "reception.10pc". For seeds, UI and sync.
- Type: number | nullorder
- Type: "active" or "inactive" or nullenumstatus
Active prices are offered for new lines; inactive are retired. Lines already sold keep pointing at a retired price.
- Type: object | nulltiersProperties: 1
When tiered: an array of {up_to, unit_amount, flat_amount}, ascending, the last with up_to null. Amounts in minor units. "$220 for the first 8, $27.50 each after" is [{up_to: 8, flat_amount: 22000}, {up_to: null, unit_amount: 2750}].
- Type: "graduated" or "volume" or nullenumtiers
_mode graduated: each tier charges for the units that fall in it. volume: the tier the total quantity lands in prices every unit.
- Type: number | nullunit
_amount Integer minor units (cents) per unit, when billing_scheme is per_unit.
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
curl https://api.hireorpheus.com/api/v1/prices \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"label": null,
"status": "active",
"order": null,
"lookup_key": null,
"billing_scheme": "per_unit",
"unit_amount": null,
"currency": null,
"tiers": null,
"tiers_mode": "graduated",
"product_id": null,
"ensemble_id": null
}'
{
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"label": null,
"status": "active",
"order": null,
"lookup_key": null,
"billing_scheme": "per_unit",
"unit_amount": null,
"currency": null,
"tiers": null,
"tiers_mode": "graduated",
"product_id": null,
"ensemble_id": null,
"created_time": "2026-10-14T08:02:53.591Z",
"last_edited_time": "2026-10-14T08:02:53.591Z"
}
}