POST /products

Create a product

Products

Description

Create a new product. Requires the "merchant" feature flag.
The product will be associated with the specified merchant.

Request Body

required

application/json

productobjectrequired
merchant_idintegerrequired
ID of the merchant creating the product. Must belong to the authenticated user.
Example: 1
original_namestringrequired
Example: Dell XPS 15 Laptop
original_descriptionstringrequired
Example: High-performance laptop with 15-inch display
brandstringrequired
Example: Dell
gtinstringrequired
Example: 1234567890123
digital_productboolean
requires_ai_digestboolean
Example: true
nameobjectrequired
Example: {"en":"Dell XPS 15 Laptop","fr":"Ordinateur portable Dell XPS 15","es":"Portátil Dell XPS 15"}
enstring
frstring
esstring
descriptionobjectrequired
Example: {"en":"High-performance laptop","fr":"Ordinateur portable haute performance","es":"Portátil de alto rendimiento"}
enstring
frstring
esstring
categoriesarray [integer]
Example: [3]
image_urlsarray [string]
Array of image URLs from the upload endpoint. URLs are moved to permanent storage when the product is created. Maximum 10 images.
Example: ["https://storage.revclic.dev/uploads/3/abc123.jpg"]

Responses

201 Product created successfully
application/json
statusstring
Example: success
dataobject
401 Not authenticated or insufficient permissions
application/json
Example:
{
  "status": "error",
  "message": "Not authenticated or insufficient permissions"
}
404 Merchant not found
application/json
Example:
{
  "status": "error",
  "message": "Merchant not found"
}
422 Validation error
application/json