GuidesAPI Reference
Log In
API Reference
These docs are for v2025.2.0. Click to read the latest docs for v2026.2.0.

Create a single product

Perform Post HTTP Request

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Serializer used for the default Create aspect

store_ids
array of integers
required

A list of the stores to which this product will be assigned. Specify '0' for All Stores.

store_ids*
string
required
length between 1 and 40

The SKU of the product.

string
required
length ≤ 50

The description of the product.

integer
required

The ID of the category assigned to the product.

integer
enum
required

The price by method.

  • 0 - Store
  • 2 - Enterprise
  • 3 - Prompt for Price
Allowed:
string | null
^-?\d{0,9}(?:\.\d{0,4})?$

The retail price of the product. If null or not provided, product will be prompt for price.

string
required
^-?\d{0,3}(?:\.\d{0,4})?$

The desired GP percentage.

integer
required

The ID of the default selling unit of measure.

string
required
^-?\d{0,9}(?:\.\d{0,8})?$

The default purchasing multiple for the product.

integer
required

The ID of the primary supplier.

integer
required

The ID of the default purchasing Unit of Measure.

product_tags
array of strings

Tags for the product.

product_tags
string
length ≤ 1000

The extended description of the product.

string | null
^-?\d{0,9}(?:\.\d{0,4})?$

The replacement cost.

string
^-?\d{0,9}(?:\.\d{0,8})?$

The default selling multiple for the product.

string
length between 1 and 50

The primary UPC code for the product.

integer

The id of the unit of measure used for the UPC code.

string
length ≤ 40

The manufacturer's SKU number for product.

boolean

Can this product be discounted?

integer
enum

The Fractional Quantity Type for the product.

  • 0 - None
  • 1 - POS Only
  • 2 - Purchasing Only
  • 3 - Both POS and Purchasing
Allowed:
integer
enum

Product serial number settings

  • 1 - Not Serialized
  • 2 - Recorded When Received
  • 3 - Recorded Only When Sold
Allowed:
integer

The unit of measure used for inventory stocking purposes.

boolean

Are on-hand inventory levels tracked for this item?

boolean

Can this item be returned by a customer?

boolean

Is this item taxable?

boolean

Can this item be sold?

boolean

Prompt for POS Note?

integer

The ID of the season code.

integer
integer

The ID of the tax code.

string
^-?\d{0,9}(?:\.\d{0,8})?$

The projected weekly velocity.

string
^-?\d{0,9}(?:\.\d{0,8})?$

The minimum order point.

string
^-?\d{0,9}(?:\.\d{0,8})?$

The maximum allowed quantity on order.

boolean

Is Order Point protected?

string
^-?\d{0,9}(?:\.\d{0,8})?$

The order point.

string
^-?\d{0,9}(?:\.\d{0,8})?$

The max stock.

string
^-?\d{0,9}(?:\.\d{0,8})?$

The stocking multiple.

Headers
integer
required

The id of the active store to be used for this API invocation

string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Response

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