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
Schlüssel anlegen
Unter Einstellungen → API-Schlüssel legst du einen Schlüssel an und gibst ihm nur die Berechtigungen, die er braucht.
- 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
Abgleichen
Über deine eigene ID in einem eigenen Feld findest du jeden Lead wieder und änderst gezielt Felder, Kontakte und Adressen.
- 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.

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-Dateien | Mit der API | |
|---|---|---|
| Neue Leads | exportieren, hochladen, Spalten zuordnen | POST, bis 5.000 pro Anfrage |
| Dubletten | von Hand bereinigen | Firma und Ort oder Telefon, zusammengeführt |
| Eigene Kunden-ID | SVERWEIS in Excel | Suche per Feldwert |
| Änderungen | ganze Datei neu | PATCH nur der geänderten Felder |
| Neuer Termin im Fremdsystem | abtippen | signierter Webhook |
| Zugriff | Login weitergeben | Schlüssel mit Berechtigungen |
Fragen zur API
Teste Coldfire 14 Tage kostenlos.
Leads importieren, Telefonie verbinden, ersten Anruf starten. Jederzeit kündbar.