HubSpot-CRM kann Eigenschaften gezielt auslesen

HubSpots CRM-Objekt-API lässt Anbindungen auswählen, welche Eigenschaften eines Datensatzes sie zurückbekommen. Der Parameter properties nimmt dafür eine Liste von Feldnamen an. Die Dokumentation der Objekt-API (Stand 3. Oktober 2026) unterscheidet diese Auswahl von historischen Werten und Verbindungen zu anderen Objekten. Eine Anbindung, die eine Vertriebsnotiz vorbereitet, fragt so nur die nötigen Felder ab.

Was steckt in der Antwort?#

Ein fehlendes Feld ist mehrdeutig. Es kann in der Anfrage fehlen, aber auch ohne gespeicherten Wert sein: HubSpot gibt eine angefragte Eigenschaft ohne Wert nicht zurück. Um die Antwort zu verstehen, braucht man deshalb auch die angeforderte Feldliste. Die Auswahl der Eigenschaften bestimmt, welche aktuellen Werte in der Antwort stehen können; historische Werte werden über den dafür vorgesehenen Parameter angefragt.

Bei Verbindungen zwischen Objekten greift eine weitere Einschränkung. associations liefert die IDs der zugeordneten Objekte. Existiert eine angefragte Zuordnung nicht, fehlt sie ebenfalls in der Antwort. Die Dokumentation unterscheidet außerdem den Abruf einzelner Objekte vom Lesen eines Stapels: Der Batch-Read unterstützt diesen Parameter nicht und verweist für Verbindungen auf die Associations-API.

Die Aufrufe lassen sich nach ihrem Zweck auseinanderhalten:

• Ein einzelner Objektabruf kann Eigenschaften und zugeordnete Objekt-IDs liefern.
• Ein Batch-Read liest bis zu 100 Datensätze; die gewünschten IDs stehen im Körper der POST-Anfrage.
• Für Zuordnungen im Stapel ist die Associations-API vorgesehen.
• Bei der Auflistung weiterer Datensätze wird der zurückgegebene after-Wert verwendet.