FlowCRM per API anbinden: Kunden, Kontakte und Leads automatisch übernehmen
05. November 2026
Über die FlowCRM-API verbindest du FlowCRM mit deiner Webseite, deinem Shop oder anderen Programmen. Typische Beispiele: Anfragen aus dem Kontaktformular landen automatisch als Lead in deiner Pipeline, neue Kunden aus dem Shop erscheinen im CRM, oder ein anderes System schreibt Timeline-Einträge. Dieser Artikel erklärt die wichtigsten Regeln. Die technischen Einzelheiten stehen in der API-Dokumentation.
Die API-Dokumentation
Die vollständige Dokumentation ist öffentlich erreichbar unter creativeskyline.de/api-dokumentation/flowcrm. Sie ist in Bereiche gegliedert, unter anderem:
- Kunden-Verwaltung, Kontakt-Verwaltung und Projekt-Verwaltung
- Timeline-Verwaltung und Projekt-Timeline
- Tags
- Leads-Verwaltung, Lead-Beziehungen, Lead-Status, Lead-Timeline, Lead-Konvertierung, Lead-Berichte und Lead-Boards
- FlowDocs
Zu jedem Endpunkt findest du dort Beschreibung, Parameter und Beispiele.

Anmelden mit einem API-Schlüssel
Jede Anfrage braucht einen Schlüssel im Kopf der Anfrage:
Authorization: Bearer <dein Schlüssel>
Akzeptiert werden ein persönlicher Schlüssel (beginnt mit pk_) und ein Team-API-Token (beginnt mit at_). Wie du ein Token anlegst, steht in Wie erstelle ich ein API-Token für Integrationen?. Behandle den Schlüssel wie ein Passwort und bau ihn nie in öffentlich sichtbaren Code ein, etwa in das JavaScript deiner Webseite. Die Anfrage an FlowCRM sollte immer von deinem Server ausgehen.
Pro Token sind bis zu 300 Anfragen pro Minute erlaubt.
Rechte
- Die Kunden-Endpunkte brauchen nur den Zugriff auf FlowCRM.
- Die Endpunkte für Leads, Lead-Boards und Lead-FlowDocs brauchen zusätzlich das Recht Leads. Fehlt es, antwortet die API mit HTTP 403.
Welche Rechte es gibt, erklärt Warum sehe ich Kunden, Projekte, Leads oder den Export nicht? Die FlowCRM-Rechte.
Leads ohne Duplikate übernehmen
Formulare und Schnittstellen schicken manchmal dieselbe Anfrage zweimal, zum Beispiel nach einem Verbindungsabbruch. Damit daraus kein doppelter Lead wird, sendest du beim Anlegen ein Paar aus Herkunft und Kennung mit, also external_source (etwa „website-formular“) und external_id (etwa die Nummer der Anfrage).
Kommt ein zweiter Aufruf mit demselben Paar an, aktualisiert FlowCRM den vorhandenen Lead, statt einen neuen anzulegen. Dabei werden nur die Felder überschrieben, die du tatsächlich mitschickst.
Zusätzlich prüft FlowCRM auch API-Leads auf ähnliche Leads, etwa mit derselben Telefonnummer. Siehe Was bedeutet „Mögliches Duplikat“ bei einem Lead?
Was mit neuen API-Leads passiert
- Neue Leads starten im Standard-Status deines Teams, also in Kalt.
- Den Status änderst du über den eigenen Status-Endpunkt. Den Status Konvertiert setzt nur die Umwandlung in einen Kunden.
- Die Originaldaten deines Formulars speichert FlowCRM mit. Sie erscheinen nie in einer API-Antwort. In der Lead-Ansicht sieht sie nur die Teamverwaltung im Abschnitt Rohdaten des Imports über Rohdaten anzeigen. So kannst du später nachvollziehen, was genau übermittelt wurde.

Kunden per API anlegen
Beim Anlegen eines Kunden sucht FlowCRM zuerst, ob es ihn schon gibt: über eine mitgesendete externe Kennung und danach über die E-Mail-Adresse. Gibt es den Kunden bereits, bekommst du ihn zurück, statt einen zweiten anzulegen. Die Antwort sagt dir mit created, ob ein neuer Kunde entstanden ist.
Wenn etwas nicht klappt
- HTTP 401: Der Schlüssel fehlt, ist falsch geschrieben oder wurde gelöscht.
- HTTP 403 bei Leads: Dem Schlüssel fehlt das Recht Leads.
- HTTP 429: Du hast mehr als 300 Anfragen pro Minute geschickt. Warte kurz und verteile die Anfragen.
- Doppelte Leads trotz Formular-Kennung: Prüfe, ob wirklich bei jedem Aufruf dasselbe Paar aus
external_sourceundexternal_idmitgeschickt wird.
War dieser Artikel hilfreich?