Dernière modification : 22 août 2025

Run in Postman

 Dans HubSpot, les produits représentent les biens ou les services que vous vendez. La création d’une bibliothèque de produits vous permet d’ajouter rapidement votre produit aux transactions et de générer des devis ainsi que des rapports sur les performances du produit. Les points de terminaison des produits vous permettent de gérer ces données et de les synchroniser entre HubSpot et d’autres systèmes. Les produits ainsi que les entreprises, les contacts, les transactions, les lignes de produit et les devis sont des objets dans le CRM de HubSpot. Découvrez-en davantage sur les propriétés d’objet, les associations, les relations et bien plus encore dans le guide Comprendre les objets de CRM. Exemple de cas d’utilisation : afin que les commerciaux puissent facilement ajouter des biens et des services aux transactions, devis, etc., utilisez l’API des produits pour importer votre catalogue de produits dans HubSpot.

​
Créer un produit

Pour créer un produit, effectuez une requête POST à crm/v3/objects/products. Dans le corps de la requête, incluez un objet properties contenant les propriétés du produit que vous souhaitez définir lors de la création. Vous pouvez ensuite mettre à jour les propriétés d’un produit via une requête PATCH vers le même point de terminaison. Pour voir toutes les propriétés de produit disponibles, effectuez une requête GET à l’API Propriétés. Pour récupérer les propriétés du produit, l’URL de la requête sera /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"
  }
}
Notez que la valeur de hs_recurring_billing_period est formatée comme P#M, où # est le nombre de mois.

​
Associer des produits

Les produits eux-mêmes ne peuvent pas être associés à d’autres objets de CRM. Cependant, pour associer les informations d’un produit à une transaction ou à un devis, vous pouvez créer une ligne de produit en fonction de ce produit. Les lignes de produit sont des instances individuelles de produits, et sont un objet distinct des produits afin que vous puissiez personnaliser les biens et services sur une transaction ou un devis sans avoir besoin de mettre à jour le produit lui-même. Par exemple, si vous préparez une transaction où l’un de vos produits est vendu, vous devez d’abord créer une ligne de produit à partir du produit, puis l’associer à la transaction. Vous pouvez le faire soit avec deux appels distincts, soit avec un appel qui crée et associe la ligne de produit. Les deux options sont présentées ci-dessous.

​
Remarque :

Les lignes de produit appartiennent à un seul objet parent. Si vous associez des objets, les lignes de produit doivent être individuelles à chaque objet. Par exemple, si vous créez une transaction et un devis, vous devez créer un ensemble de lignes de produit pour la transaction et un autre ensemble pour le devis. Cela aidera à rationaliser les données CRM entre les objets et à prévenir la perte de données inattendue lorsque vous devez modifier des lignes de produit. Par exemple, la suppression d’un devis supprimera également les lignes de produit du devis. Si ces lignes de produit sont également associées à une transaction, les lignes de produit de la transaction seront également supprimées.

​
Créer et associer une ligne de produit (appels multiples)

Tout d’abord, vous allez créer une ligne de produit basée sur un produit avec l’ID 1234567. Pour obtenir une liste complète des propriétés de ligne de produit disponibles, effectuez une requête GET à l’API Propriétés. L’URL pour les lignes de produit sera crm/v3/properties/line_items. Étant donné que vous créez la ligne de produit à partir d’un produit existant, elle héritera des valeurs de propriété du produit, telles que le prix. 
{
  "properties": {
    "quantity": 1,
    "hs_object_id": "1234567", //the object ID of the product
    "name": "New line item (product-based)"
  }
}
La réponse renverra un ID de ligne de produit que vous pouvez utiliser pour l’associer à une transaction à l’aide de l’API des associations. Pour cet exemple, supposons que l’ID de ligne de produit renvoyé est 7791176460. Pour associer la ligne de produit à une transaction existante (ID : 14795354663), vous devez effectuer une requête PUT à /crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663. Cette requête utilise le type d’association par défaut. Une réponse 200 renverra des informations similaires à celles-ci : 
{
  "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"
}
Dans HubSpot, la fiche d’informations de transaction affichera la ligne de produit dans la carte Lignes de produit.
deal-record-line-item-association

​
Créer et associer une ligne de produit (appel unique)

Pour créer une ligne de produit à partir d’un produit existant et l’associer à une transaction à l’aide d’un seul appel, vous pouvez inclure un tableau associations dans la requête de création de ligne de produit. Pour créer la ligne de produit, effectuez une requête POST à crm/v3/objects/line_item. Le corps de votre requête ressemblera à ce qui suit. Notez que le associationTypeId pour l’association ligne de produit-transaction est 20. Découvrez-en davantage sur les types d’association entre les différents types de fiche d’informations de 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
        }
      ]
    }
  ]
}
Une réponse 200 renverra des détails sur la nouvelle ligne de produit. Dans HubSpot, la fiche d’informations de transaction affichera la ligne de produit dans la carte Lignes de produit.
deal-record-line-item-association