POST

Create Product With Inventory


Creates a new product with its inventory in a single call.

Pass variantsInfo.variants.inventoryItem to create inventory items for each variant in the default location. Each inventory item can track stock using either quantity (for exact stock counts) or inStock (for simple availability). If inventoryItem isn't provided, no inventory items are created.

You can also add a ribbon, brand, info sections, options, and modifiers in the same request.

Learn more about inventory management including tracking methods, preorder settings, and multi-location inventory.

Note: When you create a product with inline options or modifiers (without referencing existing customization IDs), new standalone Customization entities are automatically created. These can be reused across other products.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Product write in v3 catalog
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/stores/v3/products-with-inventory

Errors
400Invalid Argument

There are 10 errors with this status code.

404Not Found

There are 3 errors with this status code.

428Failed Precondition

There is 1 error with this status code.

500Internal

There are 3 errors with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?