Add product from master catalog

Create a vendor product by selecting from the master catalog. The product name, weight, dimensions, category, brand, ingredients, allergens, and skin types are automatically copied from the master product. Vendor must provide pricing and SKU. Images are referenced from the master product unless custom images are uploaded.

The product name is NOT overridable to maintain consistency across vendors. Description and usage instructions can optionally be overridden.

If the vendor already has a product linked to the same master product, a warning is included in the response but creation is still allowed (supports different SKUs/variants).

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

ID of the master product to add to vendor inventory

float
required

Vendor-set price for this product

string
required

Vendor-specific SKU (must be unique per vendor)

integer
required

Initial stock quantity

string
Defaults to NGN

Three-letter currency code

float

Discount percentage (0-100)

string
enum
Defaults to draft

Initial product status

Allowed:
string

Override the master product description

string

Override the master product usage instructions

images
array of files

Custom images to use instead of master product images

Responses

400

Creation failed (e.g., master product not published, duplicate SKU)

401

Unauthenticated

403

Forbidden — lacks CREATE_PRODUCT permission

422

Validation error

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