Integrationen erstellen
Erstellen von Apps – Übersicht
Erfahren Sie mehr über die EntwicklerTools und den Entwickler-Accounts von HubSpot. Verwenden Sie sie, um eine Integration zu erstellen, eine App im Marketplace zu listen oder einen Test-Account zu erstellen.
Letzte Änderung: 28. August 2025
Mit Apps können Sie API-Aufrufe für Ihren HubSpot-Account authentifizieren, Events mit Webhooks abonnieren und die HubSpot-UI erweitern, z. B. mit benutzerdefinierten Karten. HubSpot bietet je nach den Anforderungen Ihrer Integration verschiedene Typen von Apps und Erweiterungen an. Im Folgenden erfahren Sie mehr über die Typen von Apps und Erweiterungen, die Sie mit HubSpot erstellen können, wie Sie mit der Erstellung beginnen und wie Sie sie in HubSpot verwalten.
Typen von Apps
Je nach Art der Integration, die Sie erstellen möchten, müssen Sie den richtigen App-Typ auswählen. Im Folgenden erfahren Sie mehr über die Typen von Apps, die Sie erstellen können, und die Funktionen, die sie unterstützen. Für um Erstellen von Erweiterungen finden Sie in der folgenden Referenztabelle eine kurze Übersicht darüber, welche Erweiterungen mit welchen Typen von Apps erstellt werden können.Private Apps
Private Apps können für einen einzelnen HubSpot-Account erstellt werden und eignen sich am besten für einmalige Skripts oder Einzelfallerweiterungen. Im Allgemeinen sind private Apps einfacher zu implementieren als öffentliche Apps. Private Apps authentifizieren sich über Zugriffstoken und können nicht im HubSpot App Marketplace gelistet werden. Sie können beispielsweise eine private App für Ihren HubSpot-Account erstellen, um:- Ein neues benutzerdefiniertes Objekt über die API zu erstellen.
- CRM-Datensätze von einer CSV-Datei zu importieren.
- API-Anfragen in benutzerdefinierten Automatisierungsaktionen und Chat-Bots zu authentifizieren.
- Webhook-Abonnements zu erstellen und zu bearbeiten.
Private Apps in Projekten (BETA)
Private Apps, die mithilfe des Entwicklerprojekt-Frameworks erstellt wurden, ermöglichen es Ihnen, UI-Erweiterungen für CRM-Datensätze und Helpdesk-Vorschaubereiche zu erstellen. Sie benötigen ein Sales Hub- oder Service Hub Enterprise-Abonnement, um eine UI-Erweiterung für eine private App in einer Standard-HubSpot-Account zu erstellen. Sie können diese Tools jedoch kostenlos in einem Entwickler-Test-Account testen. Um loszulegen, melden Sie Ihren Account für die Beta-Version an und folgen Sie dann der Schnellanleitung.Öffentliche Apps
Öffentliche Apps können in mehreren Accounts installiert werden. Neben den Typen von Erweiterungen, die Sie mit einer privaten App erstellen können, unterstützen öffentliche Apps erweiterte Funktionen, z. B.:- Account-übergreifende Events mithilfe der Webhooks-API abonnieren
- Benutzerdefinierte Chronik-Events in CRM-Datensätzen mithilfe der Chronik-Events-API erstellen
- Benutzerdefinierte App-Einstellungsseiten in HubSpot erstellen
Öffentliche Apps in Projekten (BETA)
Öffentliche Apps, die mithilfe des Entwicklerprojekt-Frameworks erstellt wurden, ermöglichen es Ihnen, UI-Erweiterungen für CRM-Datensätze und Helpdesk-Vorschaubereiche zu erstellen. Sie können auch andere Erweiterungen in eine auf diese Weise erstellte öffentliche App einfügen, aber Sie müssen diese Erweiterungen wie bisher in HubSpot und über die API verwalten. Wenn Sie für die Beta-Version angemeldet sind, befolgen Sie zunächst die Schnellanleitung, oder erfahren Sie in diesem Artikel, wie Sie eine vorhandene öffentliche App in das Projekt-Framework migrieren.Unterstützte Erweiterungen nach App-Typ
| App-Typ | Unterstützte Erweiterungen |
|---|---|
| Private App | UI-Erweiterungen werden in mit dem Projekte-Tool erstellen privaten Apps (BETA) unterstützt. |
| Öffentliche App | UI-Erweiterungen werden in mit dem Projekte-Tool erstellten öffentlichen Apps (BETA) unterstützt. |
*Klassische CRM-Karten unterscheiden sich von den App-Karten, die Sie als UI-Erweiterungen mit dem Projekte-Tool erstellen können. UI-Erweiterungen bieten mehr erweiterte Funktionen und anpassbare Komponenten
Account-Typen für die App-Entwicklung
App-Entwickler- und Test-Accounts arbeiten zwar zusammen, dienen jedoch einem jeweils anderen Zweck.- App-Entwickler-Accounts dienen zum Erstellen und Listen von Apps im App Marketplace.
- Entwickler-Test-Accounts, die in Test-Accounts erstellt werden können, sind für das Testen von APIs und Apps gedacht, die Sie erstellen, ohne dass die Daten in einem echten HubSpot-Account beeinträchtigt werden.
- Wenn Sie ein Sales Hub oder Service Hub Enterprise-Abonnement haben, können Sie Entwicklungs-Sandboxes in einem Standard-HubSpot-Account verwenden, um schnell weiterzuentwickeln , ohne die Daten oder Ressourcen des Accounts zu beeinträchtigen.
Authentifizierung
Wenn Sie eine benutzerdefinierte Integration mit einem einzelnen HubSpot-Account erstellen möchten, können Sie eine private App erstellen und deren Zugriffstoken zum Authentifizieren von API-Aufrufen verwenden oder Sie können OAuth mit einer öffentlichen App verwenden. Jede App, die für die Installation durch mehrere HubSpot-Accounts oder für ein Listing im App Marketplace entwickelt wurde, muss OAuth verwenden. Wenn Sie Webhooks abonnieren oder OAuth für Ihre App einrichten möchten, sollten Sie einen Entwickler-Account erstellen. Mit Entwickler-Accounts können Sie außerdem Ihre Apps im App Marketplace listen oder einen Test-Account erstellen.Entwickler-API-Schlüssel
Um die Einstellungen Ihrer App über die API zu verwalten, können Sie einen Entwickler-API-Schlüssel verwenden. Dieser API-Schlüssel ist getrennt von Standard-API-Schlüsseln, die veraltet sind. App-Entwickler-Schlüssel können für das Verwalten von Abonnements für die Webhooks-API und das Erstellen oder Aktualisieren von Event-Typen für das Chronik-Events-Feature verwendet werden. Alle anderen API-Aufrufe müssen mit dem Zugriffstoken für eine private App oder OAuth vorgenommen werden. So greifen Sie auf den API-Schlüssel Ihres App-Entwickler-Accounts zu:- Gehen Sie in Ihrem App-Entwickler-Account in der linken Navigationsleiste zu Schlüssel > Entwickler-API-Schlüssel.
- Klicken Sie auf Benutzer erstellen.
- Sobald der Schlüssel erstellt wurde, können Sie auf ** Schlüssel anzeigen** klicken. Der Schlüssel wird offengelegt, und Sie können dann unter dem Schlüssel auf Kopieren klicken.
- Um eine Liste der kürzlich mit dem Schlüssel verknüpften Sicherheitsaktionen anzuzeigen, klicken Sie auf Protokolle anzeigen.
- Sie können auch den aktuellen API-Schlüssel rotieren, indem Sie auf das Dropdown-Menü Aktionen klicken, den Mauszeiger über Schlüssel rotieren bewegen und dann auf Deaktivieren und diesen Schlüssel jetzt rotieren klicken.
- Um den Schlüssel zu deaktivieren, ohne einen neuen zu generieren, klicken Sie auf das Dropdown-Menü Aktionen, bewegen Sie den Mauszeiger über Schlüssel deaktivieren und klicken dann auf Diesen Schlüssel jetzt deaktivieren.
Einen Entwickler-Account löschen
Sie können API-Entwickler-Accounts löschen, wenn sie keine Apps mit Installationen oder aktiven Marketplace-Listings enthalten. Wenn Ihr Account über Apps mit Installationen oder aktiven Marketplace-Listings verfügt und Sie Ihren Account löschen möchten, wenden Sie sich bitte an den Support. Nachdem Sie Ihren Account gelöscht haben, können Sie nicht mehr auf diesen Account zugreifen. Wenn Sie zwischen mehreren HubSpot-Accounts wechseln können, wird der gelöschte Account nicht mehr angezeigt. Klicken Sie in Ihrem HubSpot-API-Entwickler-Account oben rechts auf Ihren Account-Namen und klicken Sie dann auf Account.
