Get Started

Create catalog item

POST/api/v1/catalog-items

Create a new Products & Services catalog item.

Operation ID: create_catalog_item_api_v1_catalog_items_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

Schema: CatalogItemCreateRequest

namestringrequired

Item name.

item_typestring

One of: service, non_inventory, inventory, bundle.

skustring

Optional SKU/code.

descriptionstring

Default sales description for line items.

unit_priceinteger

Default sales price in cents (e.g. 15000 = $150.00).

purchase_costinteger

Default purchase cost in cents.

is_soldboolean

Item is available on sales documents.

is_purchasedboolean

Item is available on purchase documents.

taxableboolean

Item is taxable by default.

income_ledger_idstring

Revenue ledger account used when this item is sold.

expense_ledger_idstring

Expense ledger account used when this item is purchased.

Responses

201Successful Response

Schema: CatalogItemResponse

idstringrequired

Catalog item UUID.

business_idstringrequired

Business UUID.

namestringrequired
item_typestringrequired
skustring
descriptionstring
unit_priceinteger
purchase_costinteger
is_soldbooleanrequired
is_purchasedbooleanrequired
taxablebooleanrequired
income_ledger_idstring
expense_ledger_idstring
income_ledger_namestring
expense_ledger_namestring
is_activebooleanrequired
created_atstring · date-timerequired
updated_atstring · date-timerequired

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

409Conflict - Resource already exists

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject