POST /v1/products
POST
/v1/products
const url = 'https://seu-endereco-da-api/v1/products';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"example","price":1,"description":"example","imageKey":"example","imageMime":"example","categoryId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","sku":"example","barcode":"example","stock":1,"active":true}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://seu-endereco-da-api/v1/products \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "example", "price": 1, "description": "example", "imageKey": "example", "imageMime": "example", "categoryId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "sku": "example", "barcode": "example", "stock": 1, "active": true }'Permissão que a Chave de acesso precisa: Gerenciar catálogo (catalog:manage).
Authorizations
Seção intitulada “Authorizations”Request Bodyrequired
Seção intitulada “Request Bodyrequired”Media typeapplication/json
object
name
required
string
price
number
description
string
imageKey
string
imageMime
string
categoryId
string format: uuid
sku
string
barcode
string
stock
number
active
boolean
Example generated
{ "name": "example", "price": 1, "description": "example", "imageKey": "example", "imageMime": "example", "categoryId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "sku": "example", "barcode": "example", "stock": 1, "active": true}Responses
Seção intitulada “Responses”Media typeapplication/json
object
id
required
string
name
required
string
price
required
Price in the smallest currency unit (centavos)
number
description
required
string
imageKey
required
string
imageMime
required
string
imageUrl
required
Signed url, valid for one hour
string
categoryId
required
string
sku
required
string
barcode
required
string
stock
required
Null means unlimited
number
active
required
boolean
optionNames
required
Names of the option groups, e.g. Size and Color; empty when the product has no variants
Array<string>
variantCount
required
Number of live variants
number
priceFromCents
required
Lowest price among active variants, in centavos
number
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
Example generated
{ "id": "example", "name": "example", "price": 1, "description": "example", "imageKey": "example", "imageMime": "example", "imageUrl": "example", "categoryId": "example", "sku": "example", "barcode": "example", "stock": 1, "active": true, "optionNames": [ "example" ], "variantCount": 1, "priceFromCents": 1, "createdAt": "2026-04-15T12:00:00Z", "updatedAt": "2026-04-15T12:00:00Z"}