Skip to main content
POST
Create store product

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
data
object
required

Response

id
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
deleted_at
string<date-time> | null
required

When the product was soft-deleted, or null if it has not been deleted.

store_id
string
required

ID of the store this product belongs to.

Pattern: ^[0-9]+$
department_id
string
required

ID of the store department this product belongs to.

Pattern: ^[0-9]+$
tax_rates
object[]
required

Tax rates applied to this product at the register.

item_modifiers
object[]
required

Item modifiers available for this product.

food_modifier_categories
object[]
required

Food modifier categories, and their modifiers, available for this product, ordered by category priority.

additional_barcodes
object[]
required

Barcodes that resolve to this product in addition to the primary barcode.

variable_weights
object[]
required

Preset weights for products sold by weight.

brand
string | null
required

Brand name.

description
string | null
required

Short description, intended for character-limited use cases (e.g., printed receipts).

active
boolean
required

Whether the product is active.

name
string
required

Human-readable product name.

barcode
string
required

Primary barcode.

target_margin
string | null
required

Target gross margin for pricing decisions, as a whole-number percentage (35 means 35%).

Pattern: ^-?[0-9]+(\.[0-9]+)?$
Example:

"199.99"

case_size
integer | null
required

Number of sellable units in a vendor case.

pack_size
integer | null
required

Number of units in a retail pack.

print_physical_tag
boolean
required

Whether a physical shelf tag should be printed for this product.

esl_enabled
boolean
required

Whether electronic shelf labels are enabled for this product.

label_last_printed_at
string<date-time> | null
required

When a shelf tag was last printed for this product.

wicable
integer | null
required

WIC eligibility indicator.

min_customer_age
integer | null
required

Minimum customer age, in years, required to purchase.

wic_enabled
boolean
required

Whether the product is eligible for WIC payment.

snap_enabled
boolean
required

Whether the product is eligible for SNAP payment.

ebt_enabled
boolean
required

Whether the product is eligible for EBT/SNAP payment.

ecommerce_enabled
boolean
required

Whether the product is available for e-commerce.

variable_sale_price
boolean
required

Whether the sale price is entered at the register instead of fixed.

sold_by_weight
boolean
required

Whether the product is sold by weight rather than by unit.

prompt_for_quantity
boolean
required

Whether the register prompts for a quantity when the product is scanned.

manual_item
boolean
required

Whether the product is entered manually at the register rather than scanned.

is_tippable
boolean
required

Whether purchases of this product can include a tip.

is_blackhawk_gift_card
boolean
required

Whether the product is a Blackhawk gift card.

is_reloadable_blackhawk_gift_card
boolean
required

Whether the product is a reloadable Blackhawk gift card.

snap_incentive_earnable
boolean
required

Whether purchases of this product earn SNAP incentives.

snap_incentive_redeemable
boolean
required

Whether SNAP incentives can be redeemed against this product.

discount_restrictions
enum<string>[] | null
required

Discount types that may not be applied to this product.

Available options:
NO_DISCOUNT_WHEN_ON_PROMOTION,
NO_DISCOUNTING,
NO_DOUBLE_DISCOUNTING
loyalty_points_per_dollar
string | null
required

Loyalty points earned per dollar spent. Null defaults to one point per dollar.

Pattern: ^[0-9]+(\.[0-9]+)?$
Example:

"199.99"

unit_volume_quantity
string | null
required

Net content quantity, in the unit given by unit_volume_uom_name.

Pattern: ^-?[0-9]+(\.[0-9]+)?$
Example:

"199.99"

unit_volume_uom_name
string | null
required

Unit of measure for unit_volume_quantity.

unit_price
string | null
required

Retail price per unit of measure, in dollars.

Pattern: ^-?[0-9]+(\.[0-9]+)?$
Example:

"199.99"

retail_price
string<positive-monetary> | null
required

Current shelf/retail price in dollars.

Pattern: ^[0-9]+(\.[0-9]+)?$
Example:

"199.99"

minimum_retail_price
string<positive-monetary> | null
required

Lower bound for the retail price, in dollars.

Pattern: ^[0-9]+(\.[0-9]+)?$
Example:

"199.99"

maximum_retail_price
string<positive-monetary> | null
required

Upper bound for the retail price, in dollars.

Pattern: ^[0-9]+(\.[0-9]+)?$
Example:

"199.99"

retail_price_effective_at
string<date-time> | null
required

When the current retail price took effect.

retail_price_unit_of_measure
object | null
required

Unit of measure the retail price applies to.

disable_pos_sync
boolean
required

Whether synchronization of this product to the point-of-sale is disabled.

primary_vendor_configuration
enum<string>
required

How the primary vendor is selected for this product.

Available options:
LATEST_COST,
SELECTED_BY_USER
country_of_origin
string | null
required

ISO 3166-1 alpha-3 country code of origin.

Required string length: 3
sync_to_deli_scales
boolean
default:false
required

Whether the product is synchronized to deli scales.

active_vendor
object

The vendor currently supplying this product.

active_vendor_product
object

The vendor catalog entry currently supplying this product.

store_vendor_products
object[]

Vendor catalog entries for this product.

inventory
object

Current inventory levels. Included when requested via include=inventory.