Hilfe · Auswertung, Rechte, Sicherheit

API und Webhooks: Kontakte von außen anlegen

API-Schlüssel je Projekt, der Endpunkt für Website-Formulare mit allen Feldnamen, was mit unbekannten Feldern passiert und wie Buchungen weitergereicht werden.

API-Schlüssel

Einstellungen → API-Schlüssel. Jeder Schlüssel gehört zu einem Projekt, hat ein Präfix zur Wiedererkennung und legt fest, ob aus einer Anfrage ein Deal und eine Aufgabe entstehen und in welcher Pipeline. Der volle Schlüssel wird nur einmal angezeigt.

Kontakt anlegen

POST https://ihrefirma.klarkunde.de/api/inbound/contacts
Authorization: Bearer <API-Schlüssel>
Content-Type: application/json

{
  "vorname": "Lena", "nachname": "Hartmann",
  "email": "lena@example.com", "telefon": "0171 2345678",
  "firma": "Hartmann GmbH", "nachricht": "Bitte um Angebot",
  "plz": "64658", "dachflaeche": "62 m²"
}

Feldnamen dürfen deutsch oder englisch, groß oder klein geschrieben sein: Vorname, Nachname, Name, E-Mail, Telefon, Firma, Position, Nachricht, Notizen, Deal-Titel, Deal-Wert, Quelle. Alle anderen Felder (hier PLZ und Dachfläche) landen als „Angaben des Kunden“ am Kontakt. Bei bekannter E-Mail wird der Kontakt ergänzt, nicht dupliziert. Enthält die Nachricht einen Konfigurationsblock, greift die Automatisierung Anfrage → Angebot.

Antwort

JSON mit Kontakt-ID, ob neu angelegt, und Deal-ID. Fehler kommen als HTTP-Status mit deutscher Meldung.

Webhooks

Buchungen über die Buchungsseite lassen sich an eine URL Ihrer Wahl weiterreichen, etwa an Make, Zapier oder Ihr eigenes System. Einstellung je Terminart.

Export

Kontakte, Firmen und Deals lassen sich jederzeit als CSV exportieren. Bei Kündigung erhalten Sie eine vollständige Sicherung.

Individuelle Anbindungen

Shop, Buchhaltung, Newsletter: Fix it IT-Service baut die Verbindung auf Wunsch.

Verwandte Anleitungen