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 Zahnradsymbol settings, 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 dann den Schlüssel einfügen, um ihn Ihren Entwicklern bereitzustellen, oder ihn in Ihren Anwendungen verwenden.

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 Wechseln 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 Wechseln Ihres HubSpot-API-Schlüssels.

Erinnerungen, den API-Schlüssel zu wechseln, werden in den folgenden Intervallen und in Form folgender Benachrichtigungstypen an Super-Admins sowie die Benutzer gesendet, die den API-Schlüssel zuletzt erstellt haben:

• Wenn der API-Schlüssel fünf Monate in Verwendung ist, werden E-Mail-Benachrichtigungen gesendet.
• Wenn der API-Schlüssel sechs Monate in Verwendung ist, werden Seitenleistenbenachrichtigungen gesendet.
• Wenn der API-Schlüssel sechs Monate lang nicht mehr gewechselt wurde, werden alle sechs Monate sowohl E-Mail-als auch Seitenleistenbenachrichtigungen gesendet.

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 abzurufen.

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

• Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Einstellungssymbol.
• 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 Zahnradsymbol settings, 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 Zahnradsymbol settings, 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 zu gewährleisten, dass Sie die API-Nutzungsrichtlinien von HubSpot erfüllen, 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 Zahnradsymbol settings, 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.