HubSpot hat am 11. August 2026 im Entwickler-Changelog angekündigt, dass Administratorregeln für Datensätze mit der API-Version 2026-09 auch bei Schreibzugriffen per Schnittstelle gelten. Betroffen sind bedingte Pflichtfelder, Pflichtangaben beim Anlegen und das Recht, Verknüpfungen zu bearbeiten. Die Meldung beschreibt Fehlercodes, einen Prüfweg und eine mildere Behandlung von Datumsangaben. Der Artikel zeigt, wie Admins und Vertriebsleitung vor der Umstellung vorgehen.
HubSpot setzt mit der API-Version 2026-09 Regeln durch, die bisher nur in der Oberfläche galten. Wer Deals und Kontakte per Schnittstelle anlegt oder ändert, sollte Pflichtangaben prüfen, bevor er die Version wechselt.
Das Wichtigste in Kürze
- Die Durchsetzung beginnt mit der API-Version 2026-09 am 8. September 2026. Die Meldung nennt das ausdrücklich einen Breaking Change.
- Bedingte Pflichtfelder gelten jetzt auch für die API. Ein Beispiel: Close Date wird Pflicht, sobald die Deal-Phase auf gewonnen steht.
- Pflichtangaben beim Anlegen gelten ebenfalls. Was ein Admin unter "Datensatz erstellen" als Pflicht markiert hat, prüft die API bei POST-Aufrufen.
- Das Recht "Verknüpfungen bearbeiten" wird geprüft. Das betrifft Apps mit Anmeldung im Namen eines Benutzers.
- Ohne Admin-Regeln ändert sich nichts. Wer solche Regeln nicht gesetzt hat, bemerkt die Umstellung nicht.
Was HubSpot angekündigt hat
HubSpot hat den Eintrag am 11. August 2026 im Entwickler-Changelog veröffentlicht und seither nicht angepasst. Die Begründung: Regeln eines Admins sollen die Daten vor unbeabsichtigten Zuständen schützen. Bisher ignorierte die API sie, nur die Oberfläche setzte sie durch.
Deshalb gilt: Verstösst ein Aufruf gegen eine Regel, antwortet die API mit dem Status 400 und einem Fehlercode. Das Beispiel aus dem Eintrag zeigt, wie die Meldung aussieht:
{
"category": "VALIDATION_ERROR",
"errors": [{
"code": "MISSING_CONDITIONAL_REQUIRED_PROPERTY",
"message": "my_property is required because of a conditional property rule based on [country]"
}]
}
Dazu lautet bei Pflichtangaben beim Anlegen der Code MISSING_REQUIRED_PROPERTY. Für das fehlende Recht erscheint die Meldung "Missing 'Edit Associations' permission". Zudem lockert HubSpot die Prüfung von Datumsangaben. Werte wie ISO-8601-Texte oder Zeitstempel in Sekunden werden jetzt angepasst, und die Antwort enthält eine Warnung, was geändert wurde.
| Regel | Wo der Admin sie setzt | Folge für Anbindungen |
|---|---|---|
| Bedingtes Pflichtfeld | Einstellungen, Eigenschaften | Aufruf scheitert mit 400, wenn das Feld fehlt |
| Pflicht beim Anlegen | Einstellungen, Objekte, Datensatz erstellen | POST scheitert ohne die markierten Felder und Verknüpfungen |
| Verknüpfungen bearbeiten | Einstellungen, Benutzer und Teams | Fehler bei Apps mit Benutzeranmeldung ohne dieses Recht |
Quelle der Tabelle: HubSpot Developer Changelog, Eintrag vom 11. August 2026.
So prüfst du deine Anbindungen
Dazu rät HubSpot, die Einstellungen des Kontos anzusehen, auf das die Anbindung schreibt. Prüfe die bedingten Regeln, die Pflichtangaben beim Anlegen und die Rechte des installierenden Benutzers. Entwickler holen die aktuellen Eigenschaften über die Properties-Schnittstelle und ergänzen jeden Schreibaufruf um die Pflichtfelder.
Dabei gilt die Regel für Wiederholungen: Ein abgelehnter Aufruf darf nicht unverändert wiederholt werden, weil die Regel dieselbe bleibt. Die Fehlermeldung nennt das Feld, also lässt sie sich in einen Hinweis für Benutzer übersetzen, etwa "Für Gewonnen braucht dieser Account ein Abschlussdatum".
Einordnung: Was das für Vertrieb und Marketing heisst
Damit ist die Änderung für Verkäufer ein Gewinn: Die Daten, die eure Regeln verlangen, fehlen künftig auch bei automatisch angelegten Deals nicht mehr. Das hilft Forecast und Reporting. Der Preis sind abgelehnte Aufrufe, wenn eine Anbindung die Regeln nicht kennt. Dann können Leads aus dem Formular-Tool oder Deals aus der Buchhaltungssoftware fehlen, ohne dass ein Verkäufer es bemerkt.
So machst du als Admin eine Liste aller Anbindungen, die in dein Konto schreiben, und fragst Dienstleister nach ihrem Stand. Ändere eine Regel erst, wenn die Anbindungen darauf vorbereitet sind, und teste mit einem Testdatensatz. Die Vertriebsleitung entscheidet, welche Felder wirklich Pflicht sein müssen, denn jedes zusätzliche Pflichtfeld erhöht das Fehlerrisiko. Auch beim Thema Daten und Rechte lohnt der Blick auf MCP-Server und ihre Governance.
Fazit
HubSpot gleicht API und Oberfläche an. Das schützt die Datenqualität, kann aber stille Fehler in Anbindungen auslösen. Prüfe Regeln und Rechte, bevor du auf Version 2026-09 wechselst, und baue für abgelehnte Aufrufe eine Meldung ein, die jemand liest.
Quellen: HubSpot Developer Changelog: CRM API Write Validation Enforcement (angekündigt am 11. August 2026, ohne spätere Aktualisierung), HubSpot Developer Changelog. Foto: Lucent_Designs_dinoson20 / Pixabay. Stand: 11. August 2026.
Recherche und Entwurf KI-gestützt, geprüft und freigegeben von Andreas Brauckmann · So arbeitet die Redaktion
Änderungshistorie
- — Artikel veröffentlicht.