Mit API-Schlüsseln können Sie Ihre Website, Ihre Anwendung oder andere Tools sicher mit Ihrem Brevo-Konto verbinden, um Aufgaben wie das Hinzufügen von Kontakten, das Versenden von Kampagnen oder den Export von Daten zu automatisieren.

Gut zu wissen

• Nur der/die Eigentümer_in des Kontos oder Benutzer_innen mit der Berechtigung für API-Schlüssel können auf die Seite API-Schlüssel & MCP zugreifen, einen neuen API-Schlüssel erstellen oder einen bestehenden API-Schlüssel löschen. Weitere Informationen zu Benutzerberechtigungen und Berechtigungsstufen finden Sie in unserem entsprechenden Artikel Hinzufügen von Benutzer:innen und Zuweisen von Berechtigungen in Brevo.
• Immer wenn ein API-Schlüssel im Konto erstellt oder gelöscht wird, erhält der Kontoinhaber eine E-Mail-Benachrichtigung – einschließlich Details wie IP-Adresse und Standort.

Was ist ein API-Schlüssel?

Ein API-Schlüssel ist ein Code, der zur Identifizierung und Authentifizierung einer Anwendung oder eines/einer Benutzer:in dient. Er fungiert als eindeutige Kennung und stellt ein geheimes Token für Authentifizierungszwecke bereit. Sie können beispielsweise einen API-Schlüssel verwenden, um Ihre Website oder Ihr Informationssystem mit Brevo zu verbinden. Auf diese Weise können Sie bestimmte Trigger zwischen beiden automatisch und manuell auslösen.

Mit einem API-Schlüssel können Sie auch eine Verbindung zu unserer API herstellen, um automatisch neue Kontakte hinzuzufügen und komplexere Aufgaben zu erledigen, wie beispielsweise Folgende:

• Kampagnen über die API erstellen und planen.
• Benutzer exportieren, die zu bestimmten Listen gehören.
• Kampagnenstatistiken usw. exportieren.

Um auf die vollständige Liste der Befehle zuzugreifen, die Sie mit unserer API verwenden können, überprüfen Sie unsere API-Dokumentation.

Wo kann ich meine API-Schlüssel finden?

Um Ihre API-Schlüssel zu schützen und sie sicherer zu machen, sind Ihre bestehenden API-Schlüssel nicht sichtbar in Ihrem Brevo-Konto. Auf der Seite API-Schlüssel & MCP werden nur die letzten Ziffern der Schlüssel angezeigt, damit du bei Bedarf mehrere Schlüssel voneinander unterscheiden kannst:

Deshalb empfehlen wir Ihnen dringend, Ihren API-Schlüssel in einer sicheren Umgebung zu speichern, wenn Sie Ihren API-Schlüssel erstellen. Wenn Sie Ihren API-Schlüssel verloren haben, empfehlen wir Ihnen, einen neuen Schlüssel zu erstellen, ihn an einem sicheren Ort aufzubewahren und den alten zu ersetzen.

Einen API-Schlüssel erstellen

Wenn Sie eine Integration mit Ihrem Brevo konfigurieren, kann es sein, dass Sie einen neuen API-Schlüssel brauchen:

1. Klicken Sie auf das Dropdown-Menü Ihres Kontos und wählen Sie Settings > SMTP & API > API Keys & MCP (Einstellungen > SMTP & API > API-Schlüssel & MCP) aus.
2. Klicken Sie auf Generate new API key (Einen neuen API-Schlüssel generieren).
   
3. Geben Sie den 6-stelligen Bestätigungscode ein, der an die E-Mail-Adresse Ihres Kontos versendet wurde, und klicken Sie anschließend auf Verify (Bestätigen).
   💡 Gut zu wissen

   Sollten Sie den Code nicht erhalten haben, können Sie ihn nach einer Minute erneut per E-Mail oder SMS anfordern.
4. Benennen Sie Ihren API-Schlüssel. Denken Sie daran, anzugeben, mit welcher Integration der API-Schlüssel verwendet wird, damit Sie ihn leicht erkennen können.
5. Legen Sie für den API-Schlüssel eine Gültigkeitsdauer von 7 Tagen bis zu 1 Jahr fest oder wählen Sie eine unbegrenzte Gültigkeit aus.
   ❗️ Wichtig

   Die Auswahl von No expiration (Keine Ablaufdatum) bedeutet lediglich, dass der Schlüssel kein festgelegtes Ablaufdatum hat. Dies befreit jedoch nicht von den gesonderten Richtlinien von Brevo bezüglich Nicht-Aktivität:

   • Expiration date reached (Ablaufdatum erreicht): Sie erhalten 3 Tage vor Ablauf des Schlüssels sowie am Tag des Ablaufs eine Erinnerungs-E-Mail.
   • 90 days of inactivity (90 Tage Inaktivität): Auch wenn kein Ablaufdatum festgelegt wurde, wird der Schlüssel deaktiviert, wenn innerhalb von 90 Tagen kein erfolgreicher API-Aufruf erfolgt ist. Sie erhalten 7 Tage vorher und am Tag selbst eine Erinnerungs-E-Mail.
6. Klicken Sie auf Generate (Generieren).
   
7. Kopieren Sie Ihren API-Schlüssel und speichern Sie ihn an einem sicheren Ort.
   
   ❗️ Wichtig

   Ihr API-Schlüssel ist nur während dieses Schritts sichtbar. Nach der Erstellung Ihres API-Schlüssels können Sie ihn nicht mehr kopieren und müssen einen neuen erstellen, wenn Sie ihn verlieren.
   
8. Optional: Aktivieren Sie die Option Create MCP server API key (MCP-Server-API-Schlüssel erstellen), um eine Version des API-Schlüssels zu erzeugen, mit dem Sie ein AI-System über das MCP-Protokoll mit Brevo verbinden können. Weitere Informationen finden Sie in unserem Artikel Was ist das Model Context Protocol (MCP)?.
   💡 Gut zu wissen

   Wenn Sie die Option Create MCP server API key (MCP-Server-API-Schlüssel erstellen) aktivieren, wird der in Schritt 4 erstellte API-Schlüssel deaktiviert und stattdessen eine MCP-Version des API-Schlüssels erzeugt.
9. Klicken Sie auf OK.

Sie haben erfolgreich einen neuen API-Schlüssel erstellt.

Einen API-Schlüssel deaktivieren

Wenn Sie die Nutzung eines API-Schlüssels vorübergehend pausieren möchten, anstatt ihn vollständig zu löschen, können Sie ihn deaktivieren:

1. Klicken Sie auf Ihr Konto-Dropdown-Menü und wählen Sie Settings (Einstellungen) > SMTP & API > API Keys & MCP (API-Schlüsseln und MCP) aus.
2. Wählen Sie den API-Schlüssel, den Sie deaktivieren möchten, aus.
3. Klicken Sie auf Deactivate API key (API-Schlüssel deaktivieren).
   

Sie haben Ihren API-Schlüssel nun erfolgreich deaktiviert.

Um einen Schlüssel erneut zu aktivieren, wählen Sie ihn erneut aus und klicken Sie auf Activate API key (API-Schlüssel aktivieren).

Einen API-Schlüssel löschen

Wenn Ihr Konto kompromittiert wurde oder Sie eine Integration, die einen besonderen API-Schlüssel erfordert, nicht länger verwenden, können Sie den API-Schlüssel löschen:

1. Klicken Sie auf Ihr Konto-Dropdown-Menü und wählen Sie Settings (Einstellungen) > SMTP & API > API Keys & MCP (API-Schlüsseln und MCP) aus.
2. Wählen Sie den API-Schlüssel, den Sie löschen möchten.
3. Klicken Sie auf Delete API key (API-Schlüssel löschen).

Sie haben Ihren API-Schlüssel erfolgreich gelöscht.

Best Practices für API-Schlüssel

API-Schlüssel geben Ihnen vollen Zugriff auf Ihr Brevo-Konto und sollten genauso geschützt werden wie ein Passwort. Hier finden Sie einige bewährte Praktiken, die Sie bei der Arbeit mit API-Schlüsseln beachten sollten:

• Verwenden Sie für jede Integration einen anderen API-Schlüssel und geben Sie den Namen der Integration im Namen des API-Schlüssels an, damit Sie genau wissen, welcher Schlüssel zu jeder Integration gehört. Wenn ein API-Schlüssel kompromittiert wird, können Sie ihn löschen, ohne dass dies Auswirkungen auf Ihre anderen Integrationen hat.
• Speichern Sie Ihre API-Schlüssel in einer sicheren Umgebung, nicht in einem Word-Dokument oder auf einem Post-it-Zettel.
• Geben Sie Ihren API-Schlüssel nicht der Öffentlichkeit preis. Stellen Sie sicher, dass Sie Ihren API-Schlüssel ausblenden oder noch besser, ihn in Screenshots oder Videos ganz weglassen.
• Versenden Sie niemals einen API-Schlüssel per E-Mail, da dies den Zugriff auf Ihr Brevo-Konto ermöglicht, wenn jemand Ihr E-Mail-Konto hackt.
  
• Löschen Sie API-Schlüssel, die nicht mehr verwendet werden, um das Risiko von Datenlecks zu begrenzen.
• Stellen Sie sicher, dass Ihre aktiven Schlüssel weiterhin verwendet werden, indem Sie alle 90 Tage mindestens einen erfolgreichen API-Aufruf durchführen, auch wenn kein Ablaufdatum festgelegt ist, um eine unerwartete Deaktivierung zu vermeiden. 
• Aktivieren Sie die IP-Adress-Sperre, damit API-Aufrufe von unbekannten IP-Adressen blockiert werden, bis Sie diese autorisieren. Weitere Informationen finden Sie in unserem speziellen Artikel Autorisieren und Blockieren von IP-Adressen für die API- und SMTP-Sicherheit.

Behebung von Problemen mit Ihren API-Schlüsseln

Sollten bei Ihnen Probleme mit Ihren API-Schlüsseln auftreten, lesen Sie bitte die folgenden Tipps zur Fehlerbehebung durch, bevor Sie sich an unser Support-Team wenden.

Mein API-Schlüssel weist den Vermerk „Expires: never (Ablaufdatum: nie)“ auf, dennoch habe ich eine Warnung wegen Nicht-Aktivität erhalten

Sie haben bei der Erstellung Ihres API-Schlüssels kein Ablaufdatum angegeben, dennoch haben Sie eine E-Mail-Warnung erhalten, dass der Schlüssel aufgrund von Nicht-Aktivität deaktiviert wird.

Häufige Ursachen und Lösungen

Überprüfen Sie die Lösung

Führen Sie einen Test-API-Aufruf mit dem Schlüssel durch und überprüfen Sie anschließend auf der Seite API-Schlüssel & MCP, ob dessen Status als „aktiv“ angezeigt wird.

Sollte das Problem weiterhin bestehen, wenden Sie sich bitte an unseren Support und geben Sie dabei die letzten Ziffern des Schlüssels sowie den genauen Wortlaut der angezeigten Warnmeldung an.

Ich habe eine Sicherheits-E-Mail mit dem Betreff „Neue IP-Adresse bestätigen“ erhalten

Sie haben eine E-Mail von Brevo erhalten, in der Sie gebeten werden, einen API-Aufruf von einer unbekannten IP-Adresse zu bestätigen oder abzulehnen. Sie sind sich jedoch nicht sicher, ob dieser Aufruf legitim ist oder wie Sie nun weiter vorgehen sollen.

Häufige Ursachen und Lösungen

Überprüfen Sie die Lösung

Rufen Sie die Seite Authorized IPs (Autorisierte IP-Adressen) auf und überprüfen Sie, ob die IP-Adresse den von Ihnen erwarteten Status aufweist (autorisiert oder entfernt).

Sollten Sie nach der Änderung Ihres API-Schlüssels weiterhin Warnmeldungen zu IP-Adressen erhalten, die Sie nicht erkennen, wenden Sie sich bitte an unseren Support.

⏭️ Nächste Schritte

• Autorisieren und Sperren von IP-Adressen für API- und SMTP-Sicherheit
• Mein Konto wurde kompromittiert, was soll ich tun?
• Was ist das Model Context Protocol (MCP)?

🤔 Sie haben eine Frage?

Wenden Sie sich bei Fragen an unser Support-Team: Erstellen Sie einfach ein Ticket über Ihr Konto. Wenn Sie noch kein Konto haben, können Sie uns hier kontaktieren.

Wenn Sie Unterstützung bei einem Projekt mit Brevo suchen, können wir Sie mit der richtigen zertifizierten Brevo-Partneragentur verbinden.