Webhooks ermöglichen es dir, in Echtzeit über Ereignisse in deinem Calendly-Konto informiert zu werden. Ob du Termine automatisieren, Daten analysieren oder eigene Integrationen erstellen möchtest – der Calendly Webhook API bietet zahlreiche Möglichkeiten zur Optimierung deiner Terminplanung. In diesem Artikel erfährst du alles über die Einrichtung und Verwendung von Calendly Webhooks sowie über die neue API v2, die ab Mai 2025 die einzige Option sein wird. Zeeg bietet übrigens eine ähnliche Webhook-Funktionalität mit zusätzlichen DSGVO-konformen Optionen.
Was ist ein Calendly Webhook?
Ein Webhook ist im Wesentlichen ein automatischer Nachrichtendienst, der Informationen in Echtzeit an eine von dir festgelegte URL sendet, sobald bestimmte Ereignisse eintreten. Bei Calendly bedeutet das konkret: Wenn jemand einen Termin bucht oder storniert, kann der Calendly Webhook diese Information sofort an deine Anwendung weitergeben.
Mit der Calendly Webhook API kannst du auf drei verschiedene Ereignistypen reagieren:
- Invitee Created Events – Benachrichtigungen, wenn neue Termine gebucht werden
- Invitee Canceled Events – Benachrichtigungen, wenn Termine storniert werden
- Routing Form Submissions – Benachrichtigungen, wenn jemand ein Routing-Formular einreicht (unabhängig davon, ob ein Termin gebucht wurde oder nicht)
Diese Echtzeit-Datenübertragung ermöglicht es dir, automatisierte Workflows zu erstellen, ohne dass du regelmäßig die Calendly-API abfragen musst. Der Webhook sendet die Daten direkt an deinen Server, sobald ein relevantes Ereignis stattfindet.
Wer kann Calendly Webhooks nutzen?
Die Webhook-Funktionalität steht Nutzern der folgenden Calendly-Tarife zur Verfügung:
- Standard
- Teams
- Enterprise
Alle Benutzer innerhalb dieser Pläne können Webhooks konfigurieren und nutzen. Dies gilt sowohl für aktuelle als auch für Legacy-Pläne.
So richtest du einen Calendly Webhook ein
Die Einrichtung eines Calendly Webhooks erfordert einige technische Kenntnisse, ist aber mit der richtigen Anleitung gut machbar. Hier ist der Prozess im Detail:
1. Authentifizierung vorbereiten
Bevor du einen Webhook erstellen kannst, musst du dich bei der Calendly API authentifizieren. Du hast zwei Möglichkeiten:
- Persönliches Zugriffstoken (Personal Access Token)
- OAuth-Anwendung
Für die meisten individuellen Anwendungsfälle ist das persönliche Zugriffstoken der einfachste Weg. Wenn du jedoch eine Anwendung entwickelst, die von vielen Calendly-Nutzern verwendet werden soll, ist OAuth die bessere Wahl.
2. Endpoint einrichten
Du benötigst einen Webserver mit einem Endpoint (URL), der die Webhook-Daten empfangen kann. Dieser Server muss:
- Öffentlich über das Internet erreichbar sein
- HTTP POST-Anfragen akzeptieren können
- JSON-Daten verarbeiten können
Wenn du mit der Entwicklung gerade erst beginnst, kannst du Tools wie Pipedream oder Webhook.site verwenden, um einen temporären Endpoint zum Testen einzurichten.
3. Webhook-Subscription erstellen
Um die Webhook-Subscription zu erstellen, musst du eine POST-Anfrage an den Calendly API-Endpoint senden. Hier ist ein Beispiel mit cURL:
curl --request POST \
--url https://api.calendly.com/webhook_subscriptions \
--header 'Authorization: Bearer DEIN_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"url": "https://deine-website.de/calendly-webhook",
"events": [
"invitee.created",
"invitee.canceled"
],
"scope": "user"
}'Die Parameter im Anfragekörper sind:
- url: Der Endpoint, an den die Webhook-Daten gesendet werden sollen
- events: Die Ereignistypen, für die du Benachrichtigungen erhalten möchtest
- scope: Der Umfang der Benachrichtigungen ("user" für deine eigenen Ereignisse oder "organization" für Ereignisse aller Mitglieder deiner Organisation)
4. Webhook-Daten verarbeiten
Nachdem du den Webhook eingerichtet hast, wird Calendly bei jedem ausgewählten Ereignis Daten an deinen Endpoint senden. Diese Daten werden im JSON-Format übermittelt und enthalten umfangreiche Informationen zum Ereignis.
Hier ist ein vereinfachtes Beispiel für die Daten, die bei einer neuen Terminbuchung gesendet werden:
{
"event": "invitee.created",
"payload": {
"event_type": {
"uuid": "EVTTYP123",
"name": "30-minütiges Meeting"
},
"invitee": {
"uuid": "INV123",
"name": "Max Mustermann",
"email": "max@beispiel.de"
},
"scheduled_event": {
"uuid": "EVT123",
"start_time": "2025-04-15T10:00:00Z",
"end_time": "2025-04-15T10:30:00Z"
}
}
}Mit diesen Daten kannst du nun verschiedene Automatisierungen umsetzen:
- Eintrag in eine Datenbank
- Benachrichtigung an andere Systeme
- Aktualisierung deines CRM
- Erstellung von Besprechungsnotizen
- Automatische E-Mail-Bestätigungen
Migration von API v1 zu API v2
⚠️ Wichtig zu wissen: Die Calendly API v1 und die damit verbundenen Webhooks werden ab Mai 2025 schrittweise eingestellt (Source: Calendly). Wenn du also derzeit die ältere API verwendest, ist jetzt der richtige Zeitpunkt, um auf die Version 2 umzusteigen.
Die API v2 bietet mehrere Vorteile:
- Sicherere Verbindung durch OAuth 2.0
- Zusätzliche Endpoints für erweiterte Anwendungsfälle
- Bessere Verwaltung von Organisationen mit Administrator-Berechtigungen
- Detailliertere Informationen zu geplanten Ereignissen
- Möglichkeit, Informationen für alle Ereignistypen aller Mitglieder in deiner Organisation abzurufen
Beachte, dass die API v2 nicht abwärtskompatibel mit v1 ist. Die Datenstruktur für API v2-Antworten entspricht nicht dem Payload von API v1. Du musst deine Anwendung entsprechend anpassen.
👉🏻 Mehr über Calendly findest du hier:
- 7 kostenlose Calendly-Alternativen im Jahr 2025
- Calendly-Alternativen: Die 10 besten Terminbuchungs-Tools im Vergleich (2025)
- Die beste DSGVO-konforme Calendly-Alternative 2025
Beispiele für die Nutzung von Calendly Webhooks
Der Calendly Webhook API kann für verschiedene Szenarien eingesetzt werden:
1. Integration mit deinem CRM-System
Eines der häufigsten Anwendungsbeispiele ist die direkte Integration mit deinem CRM-System. Wenn ein Termin gebucht wird, kann der Webhook automatisch:
- Einen neuen Kontakt im CRM anlegen (falls noch nicht vorhanden)
- Eine Aktivität für den gebuchten Termin erstellen
- Den Status eines Leads aktualisieren
- Follow-up-Aufgaben für dein Team zuweisen
2. Automatisierte E-Mail-Kampagnen
Verknüpfe deinen Calendly Webhook mit deinem E-Mail-Marketing-Tool, um:
- Personalisierte Bestätigungsmails zu senden
- Erinnerungen vor dem Termin zu verschicken
- Nach dem Termin Follow-up-E-Mails mit relevanten Materialien zu senden
- Marketing-Kampagnen basierend auf gebuchten Terminthemen anzupassen
3. Analytik und Berichterstattung
Mit Webhooks kannst du Terminbuchungsdaten in Echtzeit erfassen und analysieren:
- Tracking der Anzahl gebuchter Termine pro Tag/Woche/Monat
- Analyse der beliebtesten Termintypen
- Überwachung der Stornierungsraten
- Erstellung von benutzerdefinierten Berichten für dein Team
4. Benutzerdefinierte Integrationen
Wenn du spezielle Anforderungen hast, die von vorhandenen Integrationen nicht abgedeckt werden, kannst du mit Calendly Webhooks eigene Lösungen entwickeln:
- Verbindung mit internen Systemen
- Aktualisierung von Projektmanagement-Tools
- Automatisierung von Rechnungsstellung bei kostenpflichtigen Terminen
- Synchronisierung mit anderen Kalendersystemen
Calendly Webhook Sicherheit und Best Practices
Bei der Arbeit mit Webhooks solltest du einige Sicherheitsaspekte und Best Practices beachten:
Sicherheitsmaßnahmen
- Authentifizierung verifizieren: Überprüfe den Webhook-Sender, um sicherzustellen, dass die Anfrage tatsächlich von Calendly kommt
- HTTPS verwenden: Stelle sicher, dass dein Webhook-Endpoint HTTPS verwendet, um die Datenübertragung zu verschlüsseln
- Zugriffsrechte einschränken: Beschränke den Zugriff auf deinen Webhook-Endpoint auf die notwendigen Systeme
- Regelmäßige Token-Rotation: Aktualisiere deine Authentifizierungstoken regelmäßig
Best Practices
- Fehlerbehandlung implementieren: Plane für mögliche Ausfälle oder Verzögerungen
- Wiederholungslogik einbauen: Falls dein Server vorübergehend nicht erreichbar ist
- Nur benötigte Ereignisse abonnieren: Abonniere nur die Ereignistypen, die du wirklich benötigst
- Webhook-Antworten überwachen: Halte die Antwortzeiten deines Servers im Auge
- Daten validieren: Überprüfe die empfangenen Daten auf Vollständigkeit und Korrektheit
Webhooks bei Zeeg – Eine Alternative zu Calendly
Wenn du nach einer Alternative zu Calendly suchst, bietet Zeeg ebenfalls leistungsstarke Webhook-Funktionalität. Als DSGVO-konforme Terminplanungslösung aus Deutschland bietet Zeeg mehrere Vorteile:
- Vollständige DSGVO-Konformität mit Hosting in Europa
- Ähnliche Webhook-Funktionalität mit Echtzeit-Benachrichtigungen
- Integration mit Apple Calendar (im Gegensatz zu Calendly, das die iCloud-Integration für neue Nutzer eingestellt hat)
- Umfangreichere kostenlose Version mit zwei Terminplanungsseiten
- Wettbewerbsfähige Preisgestaltung ab 10€ pro Benutzer/Monat
Die Webhook-Funktionalität von Zeeg lässt sich mit denselben Systemen und Anwendungen verbinden, die auch mit Calendly funktionieren, bietet jedoch zusätzliche Datenschutzvorteile für Unternehmen, die in der EU tätig sind oder mit europäischen Kunden arbeiten.
Fazit: Calendly Webhook für deine Geschäftsprozesse nutzen
Der Calendly Webhook API bietet eine leistungsstarke Möglichkeit, deine Terminplanungsdaten in Echtzeit mit anderen Systemen zu verbinden. Von einfachen Benachrichtigungen bis hin zu komplexen Automatisierungen – die Möglichkeiten sind vielfältig.
Mit der anstehenden Umstellung auf API v2 im Mai 2025 ist jetzt der ideale Zeitpunkt, um deine Integration zu aktualisieren oder neu zu gestalten. Die erweiterten Funktionen der neuen API bieten dir noch mehr Möglichkeiten, deine Terminplanungsprozesse zu optimieren.
Ob du dich für Calendly oder eine Alternative wie Zeeg entscheidest – Webhooks können einen erheblichen Unterschied in der Effizienz deiner Terminplanung und der damit verbundenen Prozesse machen.
Häufig gestellte Fragen zum Calendly Webhook
Welche technischen Kenntnisse benötige ich, um Calendly Webhooks zu nutzen?
Grundlegende Programmierkenntnisse und Verständnis von API-Anfragen sind hilfreich. Du solltest mit JSON-Datenformaten und HTTP-Anfragen vertraut sein und einen Server einrichten können, der Webhook-Daten empfangen kann.
Kann ich mehrere Webhooks für verschiedene Ereignistypen einrichten?
Ja, du kannst mehrere Webhook-Subscriptions erstellen, die auf unterschiedliche Ereignistypen reagieren oder die Daten an verschiedene Endpoints senden.
Was passiert mit Webhooks, wenn ein Administrator die Organisation verlässt?
Wenn ein Administrator, der Webhooks erstellt hat, später in seiner Rolle herabgestuft oder aus der Organisation entfernt wird, bleiben diese Webhooks aktiv. Du musst sie bei Bedarf manuell löschen.
Wie lösche ich einen Webhook?
Um eine Webhook-Subscription zu löschen, kannst du eine DELETE-Anfrage an den entsprechenden Endpoint der Calendly API senden. Die genaue Dokumentation findest du im Calendly Developer Portal.
Werden Webhooks für alle Benutzer in meiner Organisation ausgelöst?
Das hängt vom "scope"-Parameter ab, den du beim Erstellen des Webhooks festlegst. Mit "scope": "user" werden nur deine eigenen Ereignisse berücksichtigt, während "scope": "organization" Ereignisse aller Mitglieder deiner Organisation erfasst.
