Create a product

Creates a new product, optionally with its items (variants). You get the saved product back, including its new id.

Smooth POS adjusts view from the live item count: exactly one item → Single Product (even if you sent Dimensioned Product); a Single Product with two or more items → Dimensioned Product. Gift Card and Sale Operation products keep their view.

active defaults to true when you leave it out.

Required permission:

GroupPermission
ProductsCreate, edit and delete products (includes view)
Body Params
string
required
integer
required

Unique ID. Set by Smooth POS.

images
object
items
array of objects

The product's items (variants).

items
metadata
object
string
required
option_names
object
required

Names of the options your items vary by, e.g. COLOR, SIZE.

number
number
string
required

Style code.

tags
array of strings

Tags attached to the product.

tags
string
required

The product's type.

string
required

The product's vendor.

boolean

Whether the product is active. Leave it out to create the product as active (true). Used for filtering lists and exports.

string
required

How the product is shown. One of Dimensioned Product, Single Product, Gift Card or Sale Operation (case-insensitive on write; unknown values are stored as Dimensioned Product). Smooth POS adjusts view from the live item count: exactly one item → Single Product; a Single Product with two or more items → Dimensioned Product. Gift Card and Sale Operation products are never changed.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json