Sie können Belbo über verschiedene Weisen mit anderen Softwareprodukten koppeln. Neben fertigen Integrationen, die Sie einfach über die Funktionsliste aktivieren können, wie zum Beispiel die Kalendersynchronisierung mit Google, können Sie auch programmatisch Buchungen erzeugen und Daten abfragen.
Wir unterscheiden dabei zwischen zwei Arten von Daten:
Öffnungszeiten, Leistungen sowie Verfügbarkeiten von Leistungen und Mitarbeitern. Diese Daten können Sie ohne Schlüssel via REST-API abfragen.
Kalender- und Kundendaten. Um sie abzufragen, benötigen Sie einen API Schlüssel.
Diesen erstellen Sie in Ihrem Kalender unter den globalen Einstellungen als API Zugang.
Nachdem Sie einen API Zugang erstellt haben, können Sie mithilfe des Tokens Abfragen durchführen. Grundsätzlich befinden sich alle Schnittstellen unter der URL mit folgendem Aufbau:
https://<IhrGeschäft>.belbo.com/office/api/<Name>?token=<Token>
Webhooks
Neben dem aktiven Abfragen von Daten können Sie in der API-Funktion auch Webhooks hinterlegen. Ein Webhook dreht die Richtung um: Ihr System muss nicht regelmäßig nachfragen, ob es etwas Neues gibt – Belbo meldet sich von selbst.
Einen Webhook legen Sie direkt in der API-Funktion an. Für die Definition sind drei Angaben nötig:
Eine Auswahlbox mit den in Ihrem Kalender angelegten API Zugängen. Der gewählte Schlüssel bestimmt, mit welchen Berechtigungen der Webhook ausgelöst wird.
Eine frei wählbare Bezeichnung, um mehrere Webhooks auseinanderzuhalten. Sie wird nur intern angezeigt.
Die vollständige Zieladresse inklusive https://, an die Belbo die Ereignisse sendet. Relative Adressen sind nicht möglich.
Welche Ereignisse einen Webhook auslösen:
Jeder Aufruf trägt einen Ereignistyp (event_type). Der Typ bestimmt, wann Belbo sendet – und welche Daten im Payload stehen. Es gibt drei Payload-Arten: Termin, Kunde und Warteliste. Dieselben Ereignisse liegen auch der Zapier-App zugrunde.
| Payload | event_type | Wird ausgelöst |
|---|---|---|
| Termin | new_appointment | Ein Termin wurde gebucht. |
new_course_booking | Ein Kurs wurde gebucht. | |
voucher_bought | Ein Gutschein wurde gekauft. | |
product_bought | Ein Produkt wurde verkauft. | |
customer_registered | Der Kunde hat sich zum Termin angemeldet. | |
customer_checked_in | Der Kunde wurde zum Termin eingecheckt. | |
appointment_reminder | Die Terminerinnerung wird fällig. | |
| Kunde | new_customer | Ein neuer Kunde wurde angelegt. |
updated_customer | Kundendaten wurden geändert. | |
| Warteliste | new_waitlist | Ein neuer Wartelisteneintrag ist entstanden. |
Alle terminbezogenen Ereignisse – also auch Kurs-, Gutschein- und Produktverkäufe – liefern dieselbe Struktur. Was gekauft bzw. gebucht wurde, steht dabei in services:
{
"booking_id": 53429371,
"appointment_start": "2026-10-17T07:00:00+0000",
"appointment_end": "2026-10-17T07:30:00+0000",
"services": [
"Paket A (Haarschnitt & Föhnen)"
],
"gender_type": "MALE",
"first_name": "Max",
"last_name": "Mustermann",
"email": "max.mustermann@example.com",
"mobile": "123123123"
}
Die Zeitangaben kommen im Format JJJJ-MM-TT'T'hh:mm:ss+0000, services ist immer eine Liste (bei mehreren gebuchten Leistungen enthält sie mehrere Einträge). Die Ereignisse new_customer und updated_customer senden statt der Termindaten nur den Kundendatensatz, new_waitlist den Wartelisteneintrag.
Automatisierungen mit Zapier
Neben der direkten Nutzung der API bietet Belbo auch die Möglichkeit, über eine Zapier-App Events aus Belbo zu nutzen und automatisiert weiterzuverarbeiten. Über Zapier können Sie typische Ereignisse abonnieren und in über 6.000 andere Anwendungen integrieren, um Workflows zu automatisieren.
Diese Ereignisse stehen als Trigger bereit:
- neue Terminbuchungen
- Wartelisteneinträge
- Terminänderungen oder -stornierungen
- neue Kunden oder Updates an Kundendaten
Damit lassen sich Aktionen in anderen Tools auslösen:
- Versand von E-Mails oder SMS
- Eintrag in CRM-Systeme
- Erstellung von Aufgaben in Projektmanagement-Tools
- Synchronisation mit Marketing- oder Reporting-Tools
Zapier fungiert dabei als Brücke zwischen Belbo und anderen Systemen und ermöglicht Automatisierungen auch ohne eigene Entwicklung. Technisch basiert dies auf sogenannten Triggern und Aktionen, die über Integrationen oder Webhooks umgesetzt werden können.