craftivo verbindet sich jetzt mit anderen Programmen. Über die neue offene Schnittstelle (API), Webhooks und Zapier tauschst du Kunden, Projekte, Aufgaben, Formulare und Belege automatisch mit anderer Software aus — statt Daten doppelt einzutippen.
Für wen ist das gedacht?
Dieser Bereich richtet sich an dich als Inhaber und an technische Partner (Agentur, Steuerbüro, eigene Automation). Nur der Inhaber des Betriebs kann Zugänge anlegen und verwalten. Die Funktion gehört zum Business-Plan — ohne diesen siehst du an der Stelle eine Info zum Freischalten.
Wo findest du die Einstellungen?
So gehst du vor:
- Öffne die Einstellungen deines Betriebs.
- Scrolle in der Seitenleiste zum Abschnitt „Abrechnung & Verwaltung".
- Klicke auf „API & Webhooks".
Oben stehen zwei Reiter: „API-Schlüssel" und „Webhooks".
Reiter „API-Schlüssel" — Zugänge anlegen
Ein Schlüssel ist wie ein Passwort für ein anderes Programm. Damit darf dieses Programm in deinem Namen auf craftivo zugreifen.
So legst du einen Schlüssel an:
- Klicke auf „Neuer Schlüssel".
- Vergib einen Namen (z. B. den Namen des Programms, das ihn nutzt).
- Wähle die Berechtigung:
- „Nur lesen" — das Programm darf Daten nur ansehen, nichts ändern.
- „Lesen & schreiben" — das Programm darf Daten auch anlegen und ändern.
- Bestätige.
Wichtig: Der Schlüssel wird nur einmal angezeigt. Kopiere ihn sofort und bewahre ihn sicher auf. Jeder Schlüssel gilt genau für diesen Betrieb.
Brauchst du einen Zugang nicht mehr, kannst du ihn in der Liste widerrufen. Danach ist er sofort ungültig.
Reiter „Webhooks" — craftivo meldet sich automatisch
Ein Webhook ist eine Benachrichtigung in die andere Richtung: craftivo meldet sich bei einer Adresse deiner Wahl, sobald bei dir etwas passiert — zum Beispiel, wenn ein neuer Kunde angelegt wird.
So legst du einen Webhook an:
- Wechsle auf den Reiter „Webhooks".
- Klicke auf „Neuer Webhook".
- Trage die Adresse (URL) ein, an die craftivo melden soll, und wähle die Ereignisse aus.
Jede Meldung wird signiert. Das dazugehörige Secret siehst du nur beim Anlegen und beim Rotieren — kopiere es also sofort. Zu jedem Webhook kannst du ein Test-Ereignis verschicken und im Zustellprotokoll prüfen, ob die Meldung angekommen ist.
Zapier: craftivo mit tausenden Programmen verbinden
Auf API & Webhooks steht die Kachel Zapier. Darüber öffnest du mit craftivo bei Zapier öffnen die craftivo-App bei Zapier (Einladungslink, solange die App dort noch nicht öffentlich gelistet ist).
Über Zapier hängst du craftivo an tausende weitere Programme, ohne selbst programmieren zu müssen. Ein Beispiel: Sobald eine Rechnung bezahlt ist, trägt Zapier den Betrag automatisch in deine Tabelle ein.
So gehst du vor: Lege unten einen API-Schlüssel an und hinterlege ihn bei Zapier als Zugang.
Für Entwickler: das Developer-Portal
Technische Details, eine Schritt-für-Schritt-Anleitung und die vollständige API-Referenz findest du im Developer-Portal unter www.craftivo.app/developers (dort die Bereiche „Zum Quickstart" und „API-Referenz öffnen"). Gib deinem technischen Partner am besten diesen Link zusammen mit einem passenden API-Schlüssel.
Häufige Fragen
- Ich sehe den Bereich nicht. Nur der Inhaber sieht „API & Webhooks". Bist du Bauleiter oder Bürokraft, ist der Bereich für dich nicht sichtbar.
- Es erscheint ein Hinweis zum Freischalten. Die Schnittstelle gehört zum Business-Plan. Schalte den Plan frei, um Schlüssel und Webhooks anzulegen.
- Ich habe den Schlüssel verloren. Aus Sicherheitsgründen lässt er sich nicht erneut anzeigen. Widerrufe den alten Schlüssel und lege einen neuen an.
Was die API unter anderem kann
Neben Kunden, Projekten, Aufgaben, Formularen und Belegen kannst du über die API v1 auch Zeiteinträge und Zeitkategorien lesen und schreiben – z. B. für Lohnexport oder Zeiterfassung in einem anderen System. Details stehen im Developer-Portal unter der API-Referenz.
Nach Ablauf der Testphase
Ist die API-Testphase vorbei:
- Unter API & Webhooks kannst du zum Aufräumen öffnen (Schlüssel und Hooks entfernen, die du nicht mehr brauchst).
- Die API v1 sperrt dann vor allem Schreibzugriffe; Lesen kann je nach Stand noch möglich sein. Details stehen im Developer-Portal.