Skip to main content
POST
Criar Produto
Cadastra um produto simples, um combo (is_bundle: true) ou uma variação (parent_id do combo). O payload de variação é o mesmo de um produto simples — só muda o parent_id. Veja o modelo completo em Produtos e variações.
string
required
Token no formato Bearer <seu_token>.

Campos comuns (todos os tipos)

boolean
required
false = produto simples ou variação. true = combo (agrupador, sem preço/estoque).
uuid
required
Categoria folha (sem subcategorias).
string
required
2 a 255 caracteres.
string
required
HTML/texto, até 50.000 caracteres. Pode ser null.
string[]
required
Até 5 itens. Cada um é uuid.extensão ou URL http(s)://…. Array vazio [] é permitido. URL externa é exibida como está, sem prefixo do CDN da SellTrust.
boolean
required
true oculta na vitrine.
boolean
required
Liga o chat do produto.
string
required
Mensagem automática (até 1000 caracteres) ou null.

Produto simples ou variação (is_bundle: false)

object
required
{ "price": number, "comparison": number | null }. comparison menor que price é rejeitado.
integer
required
Estoque numérico (≥ 0) ou null (sem controle). Ignorado se license_keys tiver itens — nesse caso o estoque vira o tamanho da lista.
string[]
required
Chaves/contas para entrega. Pode ser []. Máx. 5.000 por request; cada string 1–255 caracteres.
integer
required
Quantidade mínima no checkout, ou null.
string
required
Instruções pós-compra (até 30.000) ou null.
uuid
required
null para produto raiz. UUID do combo para criar uma variação.
O pai em parent_id precisa existir na loja e ter is_bundle: true. Caso contrário a API retorna 400/404.

Exemplo: produto simples com imagem por URL e estoque

Exemplo: combo

Exemplo: variação do combo (mesmo contrato do produto simples)

Nas respostas, images vem como URL pronta para <img src>. Link externo permanece o que você enviou. No combo, chat_enabled e chat_welcome_message também são gravados.