Auf den API-Schlüssel von HubSpot zugreifen

Mit dem HubSpot-API-Schlüssel können Ihre Entwickler benutzerdefinierte Anwendungen mit HubSpot-APIs erstellen. Jeder Schlüssel ist spezifisch für einen HubSpot-Account und nicht für einen Benutzer. Es ist immer nur ein Schlüssel zulässig.

API-Schlüssel aufrufen

Sie benötigen Super-Admin-Berechtigungen, um auf die API-Schlüssel Ihres Accounts zuzugreifen. 

• Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das settings Zahnradsymbol, um die Einstellungen aufzurufen.
• Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
  • Wenn noch nie ein Schlüssel für Ihren Account generiert wurde, klicken Sie auf „API-Schlüssel generieren“.
  • Wenn Sie bereits einen API-Schlüssel generiert haben, klicken Sie auf „Anzeigen“, um Ihren Schlüssel anzuzeigen.

• Klicken Sie bei angezeigtem Schlüssel auf „Kopieren“, um ihn zu kopieren. Sie können den Schlüssel dann einfügen, um ihn Ihren Entwicklern bereitzustellen oder in Ihren Anwendungen zu nutzen.

API-Schlüssel rotieren

Stellen Sie Ihren API-Schlüssel einem Entwickler bereit, kann dieser umfangreiche Änderungen an Ihrem Account über die API von HubSpot vornehmen und beispielsweise protokollierte E-Mails von verknüpften E-Mail-Konten und andere Drittanbieter-Daten lesen.

Um mehr Sicherheit zu gewährleisten, sollten Sie Ihren HubSpot-API-Schlüssel alle sechs Monate rotieren. Das Rotieren Ihres HubSpot-API-Schlüssels bewirkt, dass der vorhandene API-Schlüssel deaktiviert und ein neuer generiert wird. HubSpot zeigt das Alter der API-Schlüssel an und empfiehlt einen Zeitpunkt für das Rotieren Ihres HubSpot-API-Schlüssels.

Alle 180 Tage werden E-Mail-Benachrichtigungen an Super-Admins und Benutzer gesendet, die den API-Schlüssel zuletzt erstellt oder rotiert haben, sofern der API-Schlüssel in diesem Zeitraum nicht rotiert wurde. 

Dies kann zwar zu einer Unterbrechung des Betriebs führen und Arbeit verursachen, aber es bietet auch zusätzliche Sicherheit, indem Sie schädliche Anwendungen daran hindern, Ihre HubSpot-Informationen mit Ihrem vorhandenen API-Schlüssel aufzurufen.

So rotieren Sie Ihren HubSpot-API-Schlüssel:

• Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol.
• Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
• Klicken Sie auf das Dropdown-Menü „Aktionen“ und wählen Sie „Schlüssel rotieren“ aus.
•  Klicken Sie auf „Diesen Schlüssel jetzt rotieren und verfallen lassen“. Aktivieren Sie das reCAPTCHA-Kontrollkästchen. Ihr bestehender Schlüssel wird deaktiviert und ein neuer API-Schlüssel wird erstellt.
•  Klicken Sie auf „Kopieren“ und ersetzen Sie den deaktivierten API-Schlüssel, den Ihre Anwendungen verwendet haben, mit diesem neuen API-Schlüssel.

API-Aufrufe mit dem deaktivierten HubSpot-API-Schlüssel schlagen jetzt fehl und alle Anwendungen, die den Schlüssel verwenden, können nicht mehr auf Ihre Informationen zugreifen. 

Das Rotieren Ihres API-Schlüssels hat keinen Einfluss auf Ihre Verknüpfung mit der Salesforce-Integration. Wenn Sie jedoch eine benutzerdefinierte Integration installiert haben, müssen Sie Ihren API-Schlüssel nach dem Rotieren aktualisieren.

Bitte beachten: Verknüpfte Apps, die über den App Marketplace installiert wurden, sind nicht betroffen, wenn Sie Ihren API-Schlüssel rotieren.

API-Schlüssel deaktivieren

Beim Deaktivieren Ihres API-Schlüssels wird kein neuer Schlüssel erstellt. API-Aufrufe mit dem deaktivierten HubSpot-API-Schlüssel schlagen fehl und alle Anwendungen, die den Schlüssel verwenden, können nicht mehr auf Ihre Informationen zugreifen.

• Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das settings Zahnradsymbol, um die Einstellungen aufzurufen.
• Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
• Klicken Sie auf das Dropdown-Menü „Aktionen“.
• Klicken Sie auf „Schlüssel deaktivieren“ und dann auf „Diesen Schlüssel jetzt deaktivieren“. Aktivieren Sie das reCAPTCHA-Kontrollkästchen. 

API-Prüfprotokoll anzeigen

Sie können im Bereich „Protokoll“ anzeigen, welcher Benutzer zu welchem Zeitpunkt den API-Schlüssel des Accounts aufgerufen, erstellt oder deaktiviert hat. 

• Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das settings Zahnradsymbol, um die Einstellungen aufzurufen.
• Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
• Klicken Sie auf die Registerkarte „Prüfprotokoll“.

Aufrufprotokoll für Ihren API-Schlüssel anzeigen

Um das Debugging einer Ihrer Integrationen zu erleichtern oder die Einhaltung der API-Nutzungsrichtlinien von HubSpot zu gewährleisten, können Sie ein Protokoll Ihrer API-Schlüssel-Aufrufe für die vorherigen 7 Tage anzeigen. 

• Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das settings Zahnradsymbol, um die Einstellungen aufzurufen.
• Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
• Zeigen Sie auf der Registerkarte „API-Aufrufe“ alle Aktivitäten der letzten 7 Tage an.