Letzte Änderung: 22. August 2025

Run in Postman

 In HubSpot stellen Produkte die Waren oder Dienstleistungen dar, die Sie verkaufen. Durch das Erstellen einer Produktbibliothek können Sie schnell Produkte zu Deals hinzufügen, Angebote erstellen und Berichte zur Produkt-Performance erstellen. Produkt-Endpunkte ermöglichen es Ihnen, diese Daten zu verwalten und zwischen HubSpot und anderen Systemen zu synchronisieren. Produkte stellen zusammen mit Unternehmen, Kontakten, Deals, Tickets, Artikeln und Angeboten Objekte im HubSpot-CRM dar. In unserem Leitfaden Grundlegendes zum CRM finden Sie Informationen zu Objekteigenschaften, -zuordnungen, -beziehungen und mehr. Beispiel für einen Anwendungsfall: Damit Vertriebsmitarbeiter problemlos Waren oder Dienstleistungen zu Deals, Angeboten und mehr hinzufügen können, verwenden Sie die Produkte-API, um Ihren Produktkatalog in HubSpot zu importieren.

​
Produkt erstellen

Um ein Produkt zu erstellen, führen Sie eine POST-Anfrage an crm/v3/objects/products durch. Berücksichtigen Sie im Anfragetext ein properties-Objekt, das alle Produkteigenschaften enthält, die Sie beim Erstellen festlegen möchten. Sie können die Eigenschaften eines Produkts später durch eine PATCH-Anfrage an denselben Endpunkt aktualisieren. Um alle verfügbaren Produkteigenschaften anzuzeigen, führen Sie eine GET-Anfrage an die Eigenschaften-API durch. Um Produkteigenschaften abzurufen, lautet die Anfrage-URL /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"
  }
}
Beachten Sie, dass der Wert für hs_recurring_billing_period als P#M formatiert ist, wobei # die Anzahl der Monate ist.

​
Produkte zuordnen

Produkte selbst können nicht mit anderen CRM-Objekten verknüpft werden. Um jedoch die Informationen eines Produkts mit einem Deal oder einem Angebot zu verknüpfen, können Sie einen Artikel basierend auf diesem Produkt erstellen. Artikel sind einzelne Instanzen von Produkten und stellen ein separates Objekt von Produkten dar, sodass Sie die Waren und Dienstleistungen in einem Deal oder Angebot nach Bedarf anpassen können, ohne das Produkt selbst aktualisieren zu müssen. Wenn Sie beispielsweise einen Deal zusammenstellen, bei dem eines Ihrer Produkte verkauft wird, erstellen Sie in der Regel zunächst einen Artikel aus dem Produkt und ordnen ihn dann dem Deal zu. Sie können dies entweder mit zwei separaten Aufrufen oder mit einem Aufruf tun, der den Artikel erstellt und zuordnet. Beide Optionen sind unten dargestellt.

​
Hinweis:

Artikel gehören zu einem einzelnen übergeordneten Objekt. Wenn Objekte zugeordnet werden, sollten Artikel für jedes Objekt individuell sein. Wenn Sie beispielsweise einen Deal und ein Angebot erstellen, sollten Sie einen Satz von Artikeln für den Deal und einen anderen Satz für das Angebot erstellen. Dies trägt dazu bei, CRM-Daten über Objekte hinweg zu optimieren und unerwarteten Datenverlust zu verhindern, wenn Artikel geändert werden müssen. Wenn Sie beispielsweise ein Angebot löschen, werden auch die Artikel des Angebots gelöscht. Wenn diese Artikel auch mit einem Deal verknüpft sind, werden auch die Artikel des Deals gelöscht.

​
Einen Artikel erstellen und zuordnen (mehrere Aufrufe)

Zuerst erstellen Sie einen Artikel basierend auf einem Produkt mit der ID 1234567. Um eine vollständige Liste der verfügbaren Artikeleigenschaften zu erhalten, führen Sie eine GET-Anfrage an die Eigenschaften-API durch. Die URL für Artikel wäre crm/v3/properties/line_items. Da Sie den Artikel aus einem vorhandenen Produkt erstellen, übernimmt er Eigenschaftswerte vom Produkt, z. B. den Preis. 
{
  "properties": {
    "quantity": 1,
    "hs_object_id": "1234567", //the object ID of the product
    "name": "New line item (product-based)"
  }
}
Die Antwort gibt eine Antwort-ID zurück, die Sie verwenden können, um sie über die Zuordnungen-API einem Deal zuzuordnen. Nehmen Sie für dieses Beispiel an, dass die zurückgegebene Artikel-ID 7791176460 ist. Um den Artikel einem bestehenden Deal (ID: 14795354663) zuzuordnen, führen Sie eine PUT-Anfrage an /crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663 durch. Diese Anfrage verwendet den Standardzuordnungstyp. Eine 200-Antwort gibt Informationen zurück, die den folgenden ähneln: 
{
  "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"
}
In HubSpot zeigt der Deal-Datensatz den Artikel in der Artikel-Karte an.
deal-record-line-item-association

​
Einen Artikel erstellen und zuordnen (einzelner Aufruf)

Um einen Artikel aus einem vorhandenen Produkt zu erstellen und ihn einem Deal mit einem einzigen Anruf zuzuordnen, können Sie ein associations-Array in die Anfrage zum Erstellen eines Artikels einfügen. Um den Artikel zu erstellen, führen Sie eine POST-Anfrage an crm/v3/objects/line_item durch. Ihr Anfragetext sieht wie folgt aus. Beachten Sie, dass die associationTypeId für die Artikel-Deal-Zuordnung 20 ist. Erfahren Sie mehr über Zuordnungstypen zwischen verschiedenen Typen von CRM-Datensätzen. 
{
  "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
        }
      ]
    }
  ]
}
Eine 200-Antwort gibt Details zum neuen Artikel zurück. In HubSpot zeigt der Deal-Datensatz den Artikel in der Artikel-Karte an.
deal-record-line-item-association