Última modificação: 22 de agosto de 2025

Run in Postman

 No HubSpot, produtos consistem nas mercadorias ou nos serviços que você vende. A criação de uma biblioteca de produtos permite adicionar produtos aos negócios, gerar orçamentos e criar relatórios de desempenho do produto com rapidez. Os pontos de extremidade dos produtos permitem gerenciar esses dados e sincronizá-los entre o HubSpot e outros sistemas. Os produtos, assim como as empresas, os contatos, os negócios, os tickets, os itens de linha e os orçamentos, são objetos no HubSpot CRM. Saiba mais sobre propriedades de objeto, associações, relacionamentos e muito mais em nosso guia Noções básicas do CRM. Exemplo de caso de uso: para que os representantes de vendas possam adicionar com facilidade bens e serviços a negócios, orçamentos e muito mais, use a API de produtos para importar seu catálogo de produtos para o HubSpot.

​
Criar um produto

Para criar um produto, execute uma solicitação POST para crm/v3/objects/products. No corpo da solicitação, inclua um objeto properties contendo as propriedades de produto que você deseja definir ao criar. Posteriormente, você poderá atualizar as propriedades de um produto por meio de uma solicitação PATCH para o mesmo ponto de extremidade. Para ver todas as propriedades disponíveis do produto, execute uma solicitação GET para a API de propriedades. Para recuperar as propriedades do produto, o URL da solicitação será /crm/v3/properties/products. 
{
  "properties": {
    "name": "Implementation Service",
    "price": "6000.00",
    "hs_sku": "123456",
    "description": "Onboarding service for data product",
    "hs_cost_of_goods_sold": "600.00",
    "hs_recurring_billing_period": "P12M"
  }
}
Observe que o valor de hs_recurring_billing_period é formatado como P#M, onde # é o número de meses.

​
Associar produtos

Os produtos em si não podem ser associados a outros objetos do CRM. No entanto, para associar as informações de um produto a uma oferta ou orçamento, você pode criar um item de linha com base nesse produto. Os itens de linha são instâncias individuais de produtos e são objetos separados dos produtos para que você possa personalizar os bens e serviços em um negócio ou orçamento, conforme necessário, sem a necessidade de atualizar o produto em si. Por exemplo, ao criar um negócio em que um dos seus produtos é vendido, primeiro crie um item de linha a partir do produto e, em seguida, associe-o ao negócio. Você pode fazer isso executando duas chamadas separadas, ou uma chamada que cria e associa o item de linha. Ambas as opções são mostradas abaixo.

​
Observação:

Os itens de linha pertencem a um único objeto principal. Ao associar objetos, os itens de linha devem ser individuais para cada objeto. Por exemplo, se estiver criando um negócio e um orçamento, você deverá criar um conjunto de itens de linha para o negócio e outro conjunto para o orçamento. Isso ajudará a otimizar os dados do CRM em todos os objetos e evitará a perda inesperada de dados se for necessário modificar os itens de linha. Por exemplo, excluir um orçamento também excluirá os itens de linha do orçamento. Se esses itens de linha também estiverem associados a um negócio, os itens de linha do negócio também serão excluídos.

​
Criar e associar um item de linha (várias chamadas)

Primeiro, você criará um item de linha com base em um produto com o ID 1234567. Para obter a lista completa das propriedades de item de linha disponíveis, execute uma solicitação GET para a API de propriedades. O URL dos itens de linha seria crm/v3/properties/line_items. Como você cria o item de linha a partir de um produto existente, ele herda os valores de propriedade do produto, como preço. 
{
  "properties": {
    "quantity": 1,
    "hs_object_id": "1234567", //the object ID of the product
    "name": "New line item (product-based)"
  }
}
A resposta retornará um ID de item de linha que você pode usar para associá-lo a um negócio usando a API de associações. Para este exemplo, suponha que o ID do item de linha retornado seja 7791176460. Para associar o item de linha a um negócio existente (ID: 14795354663), você executará uma solicitação PUT para /crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663. Esta solicitação usa o tipo de associação padrão. Uma resposta 200 retornará informações semelhantes às seguintes: 
{
  "status": "COMPLETE",
  "results": [
    {
      "from": {
        "id": "14795354663"
      },
      "to": {
        "id": "7791176460"
      },
      "associationSpec": {
        "associationCategory": "HUBSPOT_DEFINED",
        "associationTypeId": 19
      }
    },
    {
      "from": {
        "id": "7791176460"
      },
      "to": {
        "id": "14795354663"
      },
      "associationSpec": {
        "associationCategory": "HUBSPOT_DEFINED",
        "associationTypeId": 20
      }
    }
  ],
  "startedAt": "2023-12-21T20:06:52.083Z",
  "completedAt": "2023-12-21T20:06:52.192Z"
}
No HubSpot, o registro do negócio exibirá o item de linha no cartão Itens de linha.
deal-record-line-item-association

​
Criar e associar um item de linha (chamada única)

Para criar um item de linha a partir de um produto existente e associá-lo a um negócio usando uma única chamada, você pode incluir uma matriz associations na solicitação de criação de item de linha. Para criar o item de linha, execute uma solicitação POST para crm/v3/objects/line_item. O corpo da sua solicitação será semelhante ao mostrado a seguir. Observe que o associationTypeId da associação de item de linha/negócio é 20. Saiba mais sobre os tipos de associação entre diferentes tipos de registos do CRM. 
{
  "properties": {
    "quantity": 1,
    "hs_object_id": "1234567", //the object ID of the product
    "name": "New line item (product-based)"
  },
  "associations": [
    {
      "to": {
        "id": "14795354663"
      },
      "types": [
        {
          "associationCategory": "HUBSPOT_DEFINED",
          "associationTypeId": 20
        }
      ]
    }
  ]
}
Uma resposta 200 retornará detalhes sobre o novo item de linha. No HubSpot, o registro do negócio exibirá o item de linha no cartão Itens de linha.
deal-record-line-item-association