curl -X POST https://crm.vistum.com.br/api/v1/products \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "name": "Plano PRO", "sku": "PRO-2026", "price": "199.90" }'
{ "data": { "id": "prod_x1", "name": "Plano PRO", "sku": "PRO-2026", "price": "199.90", "active": true, "createdAt": "2026-07-21T18:00:00.000Z", "description": null } }
Produtos
Criar produto
Cria um novo produto no catálogo do workspace. O produto nasce ativo.
POST
/
api
/
v1
/
products
curl -X POST https://crm.vistum.com.br/api/v1/products \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "name": "Plano PRO", "sku": "PRO-2026", "price": "199.90" }'
{ "data": { "id": "prod_x1", "name": "Plano PRO", "sku": "PRO-2026", "price": "199.90", "active": true, "createdAt": "2026-07-21T18:00:00.000Z", "description": null } }
Autenticação
string
required
Bearer vg_live_<sua_chave> — API Key com escopo products:writeBody
string
required
Nome do produto (até 200 caracteres).
string
Descrição (até 2000 caracteres).
string
Código/SKU (até 120 caracteres).
string | number
Preço decimal
>= 0 com até 2 casas. Aceita string ("199.90") ou número. O produto nasce ativo.curl -X POST https://crm.vistum.com.br/api/v1/products \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "name": "Plano PRO", "sku": "PRO-2026", "price": "199.90" }'
{ "data": { "id": "prod_x1", "name": "Plano PRO", "sku": "PRO-2026", "price": "199.90", "active": true, "createdAt": "2026-07-21T18:00:00.000Z", "description": null } }
400 VALIDATION, 400 INVALID_PRICE (preço fora do formato decimal aceito).