Create product

post

https://{domain_prefix}.retail.lightspeed.app/api/2026-04/products

Creates a new product.

🔒 Requires: products:write scope

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Note: You cannot include both price_including_tax and price_excluding_tax.

account_code_purchase

string

The code used to attribute the purchase of the product to a specific account for the Xero integration.

account_code_sale

string

The code used to attribute the sales of the product to a specific account for the Xero integration.

all_outlets_tax

object

Only used for tax inclusive stores.

attributes

object

brand_id

string

The brand ID.

composite

array of objects

A list of composite components.

composite

description

string

A detailed description of the Product. Note Can contain HTML.

dimensions_unit

string

enum

Unit of measurement for product dimensions. These are used to calculate variable shipping rates for stores using Lightspeed eCom.

Allowed:

handle

string

Product handle.

height

number

Product height. These are used to calculate variable shipping rates for stores using Lightspeed eCom.

images

array of objects

A list of image objects.

images

inventory

array of objects

inventory

is_active

boolean

Indicated whether the Product is active.

length

number

Product length. These are used to calculate variable shipping rates for stores using Lightspeed eCom.

loyalty_amount

number

The amount of loyalty the customer receives buying this item.

name

string

required

Product name. Note: Variants share the same name.

outlet_taxes

array of objects

Only used for tax exclusive stores.

outlet_taxes

price_excluding_tax

number

The price before tax is added.

price_including_tax

number

The price including all the relevant taxes.

product_category_id

string

The product category.

product_codes

array of objects

product_codes

product_suppliers

array of objects

product_suppliers

product_type_id

string

The product category. Note Product types are now product categories.

sku

string

Product sku. Note: Should be unique.

source

string

Indicates the origin of the product. Can be USER, SHOPIFY.

source_id

string

External reference ID.

source_variant_id

string

Secondary external reference ID.

supplier_code

string

Supplier code.

supplier_id

string

The supplier ID.

supply_price

double

Default supply price.

tag_ids

array of strings

An array of tag IDs associated with this product.

tag_ids

variants

array of objects

variants

weight

number

Product weight. These are used to calculate variable shipping rates for stores using Lightspeed eCom.

weight_unit

string

enum

Unit of measurement for product weight. These are used to calculate variable shipping rates for stores using Lightspeed eCom.

Allowed:

width

number

Product width. These are used to calculate variable shipping rates for stores using Lightspeed eCom.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Response

200OK