Create price book

POST/revenue/price-books

Creates a new price book with a currency and effective date. Price books become available for subscription assignment once created. Mark older price books as inactive rather than deleting them to preserve subscription history.

Request

Request body

Content type application/json (required).

Field	Type	Required	Description
name	string	Yes	Max length: 255
currency	string	Yes	ISO 4217 three-letter currency code. Max length: 3
is_active	boolean	No	Default: true
effective_date	string (date)	No
notes	string	No

Example

{
  "name": "Enterprise 2026",
  "currency": "USD",
  "is_active": true,
  "effective_date": "2026-01-01",
  "notes": "Approved pricing for all enterprise-tier customers from Jan 2026."
}

Responses

201 Price book created

Content type application/json, object · RevenuePriceBookV1.

Field	Type	Required	Description
id	integer	No
name	string	No	Human-readable price book name.
currency	string	No	ISO 4217 currency code this price book is denominated in. Max length: 3
is_active	boolean	No	Whether the price book is available for new subscription assignments.
effective_date	string (date)	No	Date from which this price book is valid.
notes	string, nullable	No
created_at	string (date-time)	No

422 Validation failed — check currency code or effective_date format

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/revenue/price-books" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"name": "Enterprise 2026", "currency": "USD", "is_active": true, "effective_date": "2026-01-01", "notes": "Approved pricing for all enterprise-tier customers from Jan 2026."}'