Start free trial

Create product variant

POST/api/v1/inventory/products/variants

Create a new product variant. When the business has Stripe connected, the variant is mirrored to Stripe Catalog (Product + Price); otherwise the variant is created locally with empty Stripe IDs and can be synced later.

Operation ID: create_variant_api_v1_inventory_products_variants_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: VariantCreateRequest

product_idstring

UUID of the parent product this variant belongs to.

unit_priceinteger

Sale price in cents (e.g., 2999 = $29.99).

unit_costinteger

Cost price in cents for margin calculations.

unit_cost_precisenumber

Precise unit cost in dollars with sub-cent precision (e.g. 0.0478 for $0.0478/gram).

namestring

Variant name (e.g., 'Large - Blue').

skustring

Stock Keeping Unit - unique identifier for inventory.

manufacturer_skustring

Manufacturer's SKU for supplier ordering.

barcodestring

Scannable barcode (UPC/EAN/QR). Distinct from SKU.

uomstring

Unit of measure: EA, LB, G, KG, OZ, L, ML, etc.

default_vendor_idstring

UUID of the preferred vendor for this variant.

initial_inventory_quantityinteger

Starting inventory quantity.

initial_inventory_quantity_datestring · date-time

Date for the initial inventory count (ISO 8601).

Responses

201Successful Response

Schema: SuccessEnvelope_VariantResponse_

successboolean
messagestring
codestring
dataVariantResponse

400Bad request - invalid data

404Business or product not found

409Variant with same SKU already exists

422Validation error