Criar um produto
POST
/v1/products
Cria um novo produto para o merchant. Os campos name e price são
obrigatórios. O produto é criado ativo (is_active: true).
Unicidade
sku e external_id devem ser únicos por company. Se já existir um
produto com o mesmo valor, a API retorna 422.
Autorizações
bearerAuth
Token Bearer do merchant obtido via POST /oauth2/token usando as
credenciais do merchant (não do app). Veja
Autenticação.
Tipo
HTTP (bearer)
Corpo da Requisição
application/json
JSON "name": "Camiseta Preta", "price": 199.9, "sku": "SKU-1", "external_id": "EXT-123", "description": "Camiseta 100% algodão", "image": "/uploads/a.png", "inventory": 5, "cost": 50
{
}
Respostas
Produto criado com sucesso.
application/json
JSON "data": { "id": 10, "sku": "SKU-1", "name": "Camiseta Preta", "price": 199.9, "description": "Camiseta 100% algodão", "image": "/uploads/a.png", "inventory": 5, "cost": 50, "is_active": true, "created_at": "2026-07-01 10:00:00", "updated_at": "2026-07-01 10:00:00" }
{
}
POST
/v1/products