API & Webhooks

Die CRM-API für deine Lead-Daten. Leads rein, Termine raus. Ohne CSV.

Dein System schickt neue Leads per REST-API, Coldfire führt Dubletten zusammen. Du findest jeden Lead über deine eigene ID wieder und änderst genau die Felder, die sich geändert haben. Und bei jedem neuen Termin bekommt dein Server einen signierten Webhook.

Keine Einrichtungsgebühr · jederzeit kündbar

15
Endpunkte für Leads, Listen, Aufgaben und Notizen
8
Berechtigungen, einzeln pro API-Schlüssel
5.000
Leads pro Import-Anfrage
120
Anfragen pro Minute und Bereich, je Schlüssel

Wo Lead-Daten zwischen Tools hängen bleiben

01

CSV hin und her

Export aus dem einen Tool, Import ins andere, jeden Tag. Die Spalten passen nicht, und wer es einmal vergisst, telefoniert mit alten Daten.

02

Dubletten

Dieselbe Firma kommt über zwei Wege ins CRM. Zwei Leads, zwei Caller, ein genervter Kontakt.

03

Termine abtippen

Der Termin steht im CRM, aber dein Projekt- oder Abrechnungstool weiß nichts davon. Also tippt ihn jemand ab. Oder vergisst es.

Die API in einer Minute

Schlüssel anlegen, Leads importieren, über die eigene ID wiederfinden, Webhook empfangen: ein Ablauf im Coldfire-Demo-Workspace.

Alle gezeigten Firmen, Personen und Schlüssel sind Demo-Daten.

So funktioniert's

  1. 1

    Schlüssel anlegen

    Unter Einstellungen → API-Schlüssel legst du einen Schlüssel an und gibst ihm nur die Berechtigungen, die er braucht.

  2. 2

    Leads schicken

    Dein System sendet Leads einzeln oder bis zu 5.000 auf einmal. Der Import läuft im Hintergrund, Dubletten führt Coldfire zusammen.

  3. 3

    Abgleichen

    Über deine eigene ID in einem eigenen Feld findest du jeden Lead wieder und änderst gezielt Felder, Kontakte und Adressen.

  4. 4

    Webhooks empfangen

    Bei jedem gebuchten Termin schickt Coldfire die Daten signiert an deinen Server. Per Workflow auch nach jedem dokumentierten Anruf.

Was die API für dich erledigt

API-Schlüssel mit Berechtigungen

Ein Schlüssel gehört zu deinem Workspace und sieht nur dessen Daten. Du vergibst einzelne Berechtigungen, etwa Leads lesen, Leads anlegen oder Aufgaben schreiben, oder nimmst eine Schnellauswahl. Den Schlüssel siehst du nur einmal beim Anlegen. Danach kannst du ihn neu erzeugen, pausieren oder löschen und siehst, wann er zuletzt benutzt wurde.

API-Schlüssel mit einzeln wählbaren Rechten

Leads importieren ohne Dubletten

POST /v1/leads legt einen Lead an, POST /v1/leads/import bis zu 5.000 auf einmal, mit Kontakten, Adressen und eigenen Feldern. Gibt es die Firma schon – gleicher Name und Ort oder gleiche Telefonnummer –, führt Coldfire beide zusammen: Leeres wird gefüllt, Neues ergänzt, nichts überschrieben. Der Status des Imports zeigt, was neu ist, was zusammengeführt wurde und welche Zeile nicht ging.

Leads über deine eigene ID finden

Leg ein eigenes Feld an, zum Beispiel deine Kunden-ID, und such per GET /v1/leads?cf[<Feld-ID>]=<Wert>. Die Antwort enthält den ganzen Lead mit Kontakten, Adressen und eigenen Feldern. Ein Aufruf reicht.

Gezielt ändern

PATCH /v1/leads/:id ändert genau das, was du schickst: Felder, eigene Felder, bestehende Kontakte per ID, neue Kontakte und Adressen. Was es schon gibt, legt Coldfire nicht doppelt an. DELETE markiert einen Lead als erledigt, ein neuer Import holt ihn zurück.

Listen, Aufgaben und Notizen

Lies deine Listen und blättere durch ihre Leads. Hol die Definitionen deiner eigenen Felder. Leg Aufgaben mit Fälligkeit und Zuständigem an, hake sie ab oder lösch sie. Und schreib Notizen an Leads.

Signierte Webhooks

Der Termin-Webhook schickt bei jedem gebuchten Termin ein JSON mit Termin-, Lead- und Kontaktdaten an deine URL. Mit dem Workflow-Schritt „Webhook“ geht das auch nach einem dokumentierten Anruf, mit Zusammenfassung und erkannten Feldern. Jede Anfrage trägt eine HMAC-SHA256-Signatur im Header X-Coldfire-Signature. Das Secret erneuerst du jederzeit.

Custom Activities mit Antwort

Bei einer Custom Activity ruft Coldfire deinen Server direkt auf. Der kann Betreff, Text, Textbausteine und Anhänge für die Mail zurückgeben, die sich danach öffnet. So kommt das Angebot aus deinem System gleich in die Mail.

Für wen

Entwickler

REST mit JSON, Schlüssel im Header, eine OpenAPI-Beschreibung. Fehler kommen als JSON mit Meldung und, wo es passt, einem festen Code.

Agenturen mit eigener Lead-Quelle

Dein Formular, dein Scraper oder dein Lieferant schickt Leads direkt in Coldfire. Passen sie zu den Filtern einer Liste, telefoniert der Dialer sie ab.

Teamleiter und Backoffice

Termine landen per Webhook in deinem Projekt- oder Abrechnungstool. Aufgaben und Notizen kommen aus deinen anderen Systemen.

CSV-Dateien oder die Coldfire-API

Mit CSV-DateienMit der API
Neue Leadsexportieren, hochladen, Spalten zuordnenPOST, bis 5.000 pro Anfrage
Dublettenvon Hand bereinigenFirma und Ort oder Telefon, zusammengeführt
Eigene Kunden-IDSVERWEIS in ExcelSuche per Feldwert
Änderungenganze Datei neuPATCH nur der geänderten Felder
Neuer Termin im Fremdsystemabtippensignierter Webhook
ZugriffLogin weitergebenSchlüssel mit Berechtigungen

Fragen zur API

Ja. API-Schlüssel und Webhooks gibt es in Solo und Team. Webhooks laufen als Workflow; im Solo-Plan sind bis zu drei Workflows gleichzeitig aktiv.

Teste Coldfire 14 Tage kostenlos.

Leads importieren, Telefonie verbinden, ersten Anruf starten. Jederzeit kündbar.