Atualizado em 17 de outubro de 2026

Considerações

  • Exige o escopo products:write e a permissão de criar em Gestão de Produtos.
  • Obrigatórios: type e name (os demais obrigatórios dependem do tipo e da configuração do tenant).
  • Campos por tipo — compositions (kit, com preço por item), related_key_product_id (chave-codigo), subscription_id (assinatura).
  • Aceita também os textos da aba de informações, as fotos (images) e o preço em dólar — veja a solução Textos, fotos e preço em dólar.
  • A compatibilidade com impressoras vai em printer_model_id (lista de ids de modelos).
  • A criação é idempotente: envie um Idempotency-Key; a mesma chave devolve o produto original por 24h.
  • Qualquer gravação desliga a sincronização com o Mercado Livre, como no painel.

Referência

POST /products na Referência da API

Como fazer

cURL
curl -X POST "$MICORE_BASE_URL/products" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "produto-fisico",
    "name": "Camiseta Básica",
    "reference": "CAM-001",
    "price": "79,90",
    "warranty_days": 90,
    "validity_days": 0,
    "category_id": 4,
    "unit_id": 1
}'

Resposta

Resposta · 201
{
  "data": {
    "id": 1203,
    "name": "Camiseta Básica",
    "reference": "CAM-001",
    "type": "produto-fisico",
    "status": true,
    "price": 79.9
  }
}
Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.