API
API-Keys erstellen und verwalten für Entwickler-Integrationen.
Mit der Leadbase-API kannst du programmatisch auf deine Daten zugreifen und Integrationen erstellen.
API-Übersicht
Die Leadbase-API ermöglicht:
- Kontakte lesen und schreiben: Programmatischer Zugriff auf Tabellen
- Anreicherungen starten: Kontakte automatisch anreichern
- Suchen ausführen: Personen- und Unternehmenssuche
- Webhooks empfangen: Benachrichtigungen bei Ereignissen
Für Entwickler
Diese Seite erklärt die API-Verwaltung in Leadbase. Für die technische API-Dokumentation besuche api.leadbase.de/docs.
API-Key erstellen
Neuen Key erstellen
- Gehe zu Einstellungen → API
- Klicke auf „Neuen API-Key erstellen"
- Gib einen beschreibenden Namen ein (z.B. „Zapier Integration")
- Wähle die Berechtigungen
- Klicke auf „Erstellen"
- Kopiere den Key sofort – er wird nur einmal angezeigt!
Key sicher aufbewahren
Der API-Key wird nur einmal vollständig angezeigt. Speichere ihn sicher. Bei Verlust musst du einen neuen erstellen.
Berechtigungen wählen
| Berechtigung | Beschreibung |
|---|---|
| Lesen | Kontakte und Tabellen anzeigen |
| Schreiben | Kontakte erstellen und bearbeiten |
| Löschen | Kontakte und Tabellen löschen |
| Anreichern | Anreicherungen ausführen (verbraucht Credits) |
| Suche | Such-API nutzen (verbraucht Credits) |
| Admin | Alle Berechtigungen inkl. API-Key-Verwaltung |
Minimale Rechte
Vergib nur die Berechtigungen, die für den Anwendungsfall nötig sind. Ein Zapier-Integration für Kontaktimport braucht z.B. nur „Lesen" und „Schreiben".
API-Keys verwalten
Keys anzeigen
Unter Einstellungen → API siehst du alle aktiven Keys:
| Information | Beschreibung |
|---|---|
| Name | Beschreibender Name |
| Erstellt | Erstellungsdatum |
| Zuletzt verwendet | Letzte API-Nutzung |
| Berechtigungen | Zugewiesene Rechte |
| Status | Aktiv oder deaktiviert |
Key deaktivieren
- Finde den Key in der Liste
- Klicke auf „Deaktivieren"
- Der Key funktioniert sofort nicht mehr
- Du kannst ihn später wieder aktivieren
Key löschen
- Finde den Key in der Liste
- Klicke auf „Löschen"
- Bestätige die Löschung
- Der Key ist dauerhaft ungültig
Vorsicht
Das Löschen eines Keys ist nicht rückgängig zu machen. Alle Integrationen, die diesen Key nutzen, funktionieren nicht mehr.
API-Nutzung
Rate Limits
| Plan | Anfragen/Minute |
|---|---|
| Starter | 60 |
| Professional | 300 |
| Enterprise | 1.000+ |
Bei Überschreitung erhältst du einen 429 Too Many Requests Fehler.
Nutzungsstatistiken
Unter Einstellungen → API → „Nutzung":
- Anfragen pro Tag/Woche/Monat
- Anfragen nach Endpoint
- Erfolgreiche vs. fehlgeschlagene Anfragen
- Credit-Verbrauch durch API
Webhooks
Webhook einrichten
- Gehe zu Einstellungen → API → „Webhooks"
- Klicke auf „Webhook hinzufügen"
- Gib die URL ein, die aufgerufen werden soll
- Wähle die Ereignisse, bei denen der Webhook ausgelöst wird
- Klicke auf „Speichern"
Verfügbare Ereignisse
| Ereignis | Beschreibung |
|---|---|
contact.created | Neuer Kontakt erstellt |
contact.updated | Kontakt aktualisiert |
contact.deleted | Kontakt gelöscht |
enrichment.completed | Anreicherung abgeschlossen |
enrichment.failed | Anreicherung fehlgeschlagen |
table.created | Neue Tabelle erstellt |
Webhook testen
- Finde den Webhook in der Liste
- Klicke auf „Test senden"
- Ein Test-Event wird an deine URL gesendet
- Prüfe, ob es korrekt empfangen wurde
Sicherheit
Best Practices
- Keys rotieren: Erstelle regelmäßig neue Keys
- Minimale Rechte: Nur nötige Berechtigungen vergeben
- Nicht im Code: Keys nie in Quellcode committen
- Umgebungsvariablen: Keys in Environment-Variablen speichern
- Monitoring: Überwache API-Nutzung auf Anomalien
Bei Verdacht auf Kompromittierung
- Deaktiviere den betroffenen Key sofort
- Erstelle einen neuen Key
- Aktualisiere alle Integrationen
- Prüfe die Nutzungsprotokolle
Wie hilfreich ist dieser Guide?