Mit API-Schlüsseln kannst du deine Website, deine Anwendung oder andere Tools sicher mit deinem Brevo-Konto verbinden, um Aufgaben wie das Hinzufügen von Kontakten, das Versenden von Kampagnen oder den Export von Daten zu automatisieren. Nur du entscheidest, worauf jeder Schlüssel Zugriff hat.

Gut zu wissen

• Nur der/die Eigentümer:in des Kontos oder Benutzer:innen mit der Berechtigung 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 findest du in unserem entsprechenden Artikel Benutzer:innen und Zuweisen von Berechtigungen in Brevo hinzufügen.
• Immer wenn ein API-Schlüssel im Konto erstellt oder gelöscht wird, erhält der/die Eigentümer:in des Kontos eine E-Mail-Benachrichtigung mit Angaben wie der IP-Adresse und dem Standort.
• Um alle Befehle zu sehen, die du mit unserer API nutzen kannst, überprüfe unsere API-Dokumentation.

Einen API-Schlüssel erstellen

Wenn du eine Integration mit deinem Brevo-Konto einrichtest, musst du möglicherweise einen neuen API-Schlüssel erstellen und festlegen, auf welche Daten er zugreifen darf:

1. Klicke unten links auf Einstellungen > SMTP & API > API-Schlüssel & MCP.
2. Klicke auf Generate API key (API-Schlüssel generieren).
   
3. Gib den an dein Gerät versendeten Verifizierungscode ein und klicke auf Verify (Verifizieren). Weitere Informationen findest du in unserem Artikel Identitätsprüfung für sensible Aktionen in Brevo.
4. Gib unter Key name (Schlüsselname) einen Namen für deinen API-Schlüssel ein. Achte darauf, dass der Name angibt, welche Integration ihn verwenden wird, damit du ihn leicht erkennen kannst.

5. Wähle unter Expiry (Ablaufen) aus, wie lange der Schlüssel gültig bleiben soll – von 7 Tagen bis zu 1 Jahr – oder wähle „No expiration (kein Ablaufen)“ aus.

   

   ❗️ Wichtig

   Auch wenn kein Ablaufdatum festgelegt ist, wird ein Schlüssel deaktiviert, wenn innerhalb von 90 Tagen kein erfolgreicher API Call stattgefunden hat. Du erhältst 7 Tage vorher und am Tag selbst eine Erinnerungs-E-Mail. Wenn du ein Ablaufdatum festlegst, erhältst du außerdem 3 Tage vorher und am Tag des Ablaufs eine Erinnerung.

6. Unter Access (Zugriff) kannst du auswählen, auf welche Bereiche deines Kontos der API-Schlüssel zugreifen darf:

   [Empfohlen] Restricted (Eingeschränkt) Full (Vollzugriff)

   Mit eingeschränkten Berechtigungen kann der Schlüssel nur auf die von dir ausgewählten Ressourcen zugreifen.

   Wähle unter Permissions (Berechtigungen) die Option None (Keine), Read (Lesen), Read/write (Lesen/Schreiben) oder All (Alle) für jede Ressource aus, die der Schlüssel benötigt. Weitere Informationen findest du in unserem Artikel Informationen zu API-Schlüssel-Berechtigungen.

   

   Mit Vollzugriff kann der Schlüssel auf alle aktuellen und zukünftigen Ressourcen zugreifen, daher müssen keine Berechtigungen festgelegt werden.

   

7. Kopiere deinen API-Schlüssel und speichere ihn an einem sicheren Ort.
   

   ❗️ Wichtig

   Dein API-Schlüssel ist nur während dieses Schritts sichtbar. Sobald dein API-Schlüssel erstellt ist, kannst du ihn nicht mehr kopieren und musst einen neuen erstellen, falls du ihn verlierst.
8. (Optional) So erstellst du eine Version des API-Schlüssels, mit der du ein AI-System über das MCP-Protokoll mit Brevo verbinden kannst:
   1. Aktiviere Create MCP server API key (MCP-Server-API-Schlüssel erstellen). Der Standard-API-Schlüssel wird deaktiviert und stattdessen wird eine MCP-Version des API-Schlüssels generiert.
   2. Kopiere den MCP-API-Schlüssel.
      
      Weitere Informationen findest du in unserem Artikel Was ist das Model Context Protocol (MCP)?. 
9. Klicke auf I've saved my key (Ich habe meinen Schlüssel gespeichert).

Du hast nun erfolgreich einen neuen API-Schlüssel erstellt.

Deine API-Schlüssel anzeigen

Um deine API-Schlüssel zu schützen, sind bestehende Schlüssel in deinem Brevo-Konto nicht sichtbar. Auf der Seite API-Schlüssel & MCP werden nur die letzten Ziffern der einzelnen Schlüssel angezeigt, damit du mehrere Schlüssel voneinander unterscheiden kannst:

Auf der Seite werden außerdem für jeden Schlüssel die folgenden Informationen angezeigt:

• Name: den Namen des Schlüssels und seine letzten Ziffern. Schlüssel mit einer MCP-Version tragen die Aufschrift MCP. 

  💡 Gut zu wissen

  Wenn du neben einem Schlüsselnamen ein Warnsymbol siehst, bedeutet das, dass der Schlüssel abgelaufen ist.
• Berechtigungen: 
  • Full access (Voller Zugriff) bedeutet, dass der Schlüssel auf alle Ressourcen zugreifen kann. 
  • Restricted (Eingeschränkt), gefolgt von einer Anzahl von Bereichen, bedeutet, dass der Schlüssel nur auf diese Anzahl von Ressourcen zugreifen kann. Fahre mit der Maus über die Berechtigungen, um zu sehen, welche Ressourcen der Schlüssel umfasst.
• Status: Ob der Schlüssel aktiv oder deaktiviert ist.
• Expires on (Gültig bis): das Datum, an dem der Schlüssel abläuft, oder No fixed date (Kein festes Datum), falls du kein Ablaufdatum festgelegt hast.
• Last used on (Zuletzt verwendet am): das Datum des letzten API Calls, der mit dem Schlüssel durchgeführt wurde.

API-Schlüssel bearbeiten

Falls eine Integration andere Zugriffsrechte benötigt als die, die du ihr ursprünglich gewährt hast, kannst du die Zugriffsrechte ihres API-Schlüssels jederzeit ändern. Du kannst auch den Namen und das Ablaufdatum des Schlüssels bearbeiten.

1. Klicke unten links auf Einstellungen > SMTP & API > API-Schlüssel & MCP.
2. Klicke neben dem API-Schlüssel, den du bearbeiten möchtest, auf das Drei-Punkte-Symbol und wähle Edit API key (API-Schlüssel bearbeiten) aus.
   
3. Gib den an dein Gerät versendeten Verifizierungscode ein und klicke auf Verify (Verifizieren). Weitere Informationen findest du in unserem Artikel Identität für sensible Aktionen in Brevo verifizieren. 

4. Nimm die nötigen Änderungen vor. 

   ❗️ Wichtig

   Wenn du eine Berechtigung entfernst, die eine Integration noch benötigt, schlagen deren API Calls mit dem Fehler Access denied for resource (Zugriff auf Ressource verweigert) fehl. Weitere Informationen findest du in unserem speziellen Artikel Fehlerbehebung – Probleme mit API-Schlüsseln
5. Klicke auf Save changes (Änderungen speichern). 

Du hast deinen API-Schlüssel nun erfolgreich aktualisiert.

Einen API-Schlüssel deaktivieren oder reaktivieren

Wenn du die Nutzung eines API-Schlüssels vorübergehend pausieren möchtest, anstatt ihn komplett zu löschen, kannst du ihn deaktivieren und später wieder aktivieren, wenn du ihn erneut benötigst. Du kannst auch einen Schlüssel, der deaktiviert wurde, wieder aktivieren.

1. Klicke unten links auf Einstellungen > SMTP & API > API-Schlüssel & MCP.
2. Klicke neben dem API-Schlüssel, den du deaktivieren oder reaktivieren möchtest, auf das Drei-Punkte-Symbol und wähle API-Schlüssel deaktivieren oder API-Schlüssel aktivieren.
   

Du hast deinen API-Schlüssel nun erfolgreich deaktiviert oder reaktiviert.

Einen API-Schlüssel löschen

Wenn dein Konto kompromittiert wurde oder du eine Integration, für die ein bestimmter API-Schlüssel erforderlich ist, nicht mehr nutzt, kannst du diesen API-Schlüssel löschen:

1. Klicke unten links auf Einstellungen > SMTP & API > API-Schlüssel & MCP.
2. Klicke neben dem API-Schlüssel, den du löschen möchtest, auf das Drei-Punkte-Symbol und wähle Delete API key (API-Schlüssel löschen) aus.
   

Du hast deinen API-Schlüssel nun erfolgreich gelöscht.

Best Practices für API-Schlüssel

Schütze jeden API-Schlüssel genauso wie ein Passwort. Hier sind ein paar bewährte Praktiken, die du beachten solltest:

• Verwende für jede Integration einen eigenen API-Schlüssel und füge den Namen der Integration in den Namen des Schlüssels ein. Auf diese Weise kannst du einen Schlüssel löschen, falls er kompromittiert wurde, ohne dass dies Auswirkungen auf deine anderen Integrationen hat.
• Verwende den eingeschränkten Zugriff und erteile jedem Schlüssel nur die Berechtigungen, die er benötigt. Auf diese Weise kann ein kompromittierter Schlüssel nur auf die von dir ausgewählten Ressourcen zugreifen.
• Speichere deine API-Schlüssel in einer sicheren Umgebung, nicht in einem Word-Dokument oder auf einem Post-it-Zettel.
• Gib deinen API-Schlüssel nicht der Öffentlichkeit preis. Verberge deinen API-Schlüssel oder – noch besser – schneide ihn in Screenshots oder Videos komplett heraus.
• Versende niemals einen API-Schlüssel per E-Mail. Wenn jemand dein E-Mail-Konto hackt, erhält er dadurch Zugriff auf dein Brevo-Konto.
• Lösche stets API-Schlüssel, die nicht mehr verwendet werden, um das Risiko von Datenlecks zu minimieren.
• Aktiviere die IP-Adressensperre, damit API Calls von unbekannten IP-Adressen blockiert werden, bis du sie autorisierst. Weitere Informationen findest du in unserem speziellen Artikel IP-Adressen für die API- und SMTP-Sicherheit autorisieren und blockieren.

⏭️ Nächste Schritte

• Über Berechtigungen für API-Schlüssel 
• Fehlerbehebung – Probleme mit API-Schlüsseln
• Deinen SMTP-Schlüssel erstellen oder verwalten
• IP-Adressen für die API- und SMTP-Sicherheit autorisieren und sperren
• 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.