Tutorials

Wie man Calendly mit Webhooks verbindet [2025 Easy Guide]

Melden

Hier ist ein aktueller und leicht verständlicher Guide für das Jahr 2025, wie du Calendly per Webhooks mit anderen Anwendungen verbindest.

Webhooks sind der schnellste Weg, um Daten in Echtzeit von Calendly an andere Apps (wie dein CRM, Slack oder eine eigene Datenbank) zu senden. Im Gegensatz zur normalen API-Abfrage "pusht" Calendly die Information sofort, wenn ein Ereignis eintritt.

Voraussetzungen

  • Ein Calendly Professional, Teams oder Enterprise Plan (Webhooks sind in der kostenlosen Version nicht verfügbar).
  • Ein Ziel (Endpoint URL), an das die Daten gesendet werden (z. B. Make.com, Zapier oder dein eigener Server).

Schritt 1: Erstelle deinen Ziel-Link (Webhook URL)

Bevor du in Calendly etwas einstellst, brauchst du eine Adresse, an die Calendly die Daten senden kann.

  1. Nutzt du No-Code-Tools? Gehe zu Make.com oder Zapier. Erstelle ein neues Szenario/Zap und wähle den Trigger "Webhooks" -> "Custom Webhook". Kopiere die generierte URL.
  2. Eigene Entwicklung? Stelle sicher, dass dein Server eine öffentliche URL hat und POST-Anfragen empfangen kann.

Schritt 2: Generiere deinen Calendly API-Token

Um Webhooks zu erstellen, musst du dich gegenüber Calendly authentifizieren.

  1. Logge dich in deinen Calendly-Account ein.
  2. Navigiere zu Integrations & Apps (oben im Menü).
  3. Suche nach API & Webhooks (oder gehe direkt zu den Developer Einstellungen).
  4. Klicke auf Generate New Token.
  5. Gib dem Token einen Namen (z.B. "Webhook 2025") und kopiere ihn sicher. Achtung: Du siehst ihn nur einmal!

Schritt 3: Den Webhook registrieren

Calendly bietet aktuell (Stand 2025) kein einfaches Formular im Dashboard an, um Webhooks manuell einzutragen. Du hast zwei Möglichkeiten:

Option A: Der einfache Weg (über Make oder Zapier)

Dies ist für 90% der Nutzer die beste Wahl.

  1. Wähle in Make/Zapier die App Calendly aus.
  2. Wähle als Trigger: "Watch Events".
  3. Verbinde deinen Account mit dem API-Token aus Schritt 2.
  4. Das Tool registriert den Webhook automatisch im Hintergrund für dich. Fertig!

Option B: Der manuelle Weg (für Entwickler via API)

Wenn du kein Tool dazwischen schalten willst, musst du einen POST-Request an die Calendly API senden. Nutze dafür ein Programm wie Postman oder cURL.

Endpoint: https://api.calendly.com/webhook_subscriptions

Headers:

  • Authorization: Bearer DEIN_API_TOKEN
  • Content-Type: application/json

Body (JSON):

{
  "url": "https://deine-url.de/webhook",
  "events": ["invitee.created", "invitee.canceled"],
  "organization": "https://api.calendly.com/organizations/DEINE_ORG_ID",
  "scope": "organization"
}

Tipp: Deine Organization-ID erhältst du über den API-Endpunkt /users/me.

Schritt 4: Teste die Verbindung

  1. Öffne deine Calendly-Buchungsseite in einem Inkognito-Fenster.
  2. Buche einen Test-Termin bei dir selbst.
  3. Prüfe dein Ziel (Make, Zapier oder Server-Log).
  4. Du solltest nun ein JSON-Paket mit allen Infos sehen: Name des Gastes, E-Mail, Antworten auf Fragen und der Zeitpunkt des Termins.

Welche Ereignisse (Events) kannst du tracken?

Die wichtigsten Webhook-Events in 2025 sind:

  • invitee.created: Wird ausgelöst, wenn jemand einen Termin bucht.
  • invitee.canceled: Wird ausgelöst, wenn ein Termin abgesagt wird.
  • routing_form_submission.submitted: Wenn du Calendly Routing-Formulare nutzt.

Profi-Tipps für 2025

  • Sicherheit: Überprüfe in deinem Code immer, ob die Daten wirklich von Calendly kommen (nutze dazu den webhook_signing_key, den Calendly in der Subscription-Antwort liefert).
  • Fehlerbehandlung: Wenn dein Server den Statuscode 500 zurückgibt, versucht Calendly den Webhook mehrmals erneut zu senden. Stelle sicher, dass dein Endpoint schnell mit einem Status 200 antwortet.
  • Payload-Format: Denke daran, dass Calendly Zeiten immer in UTC sendet. Du musst sie für deutsche Nutzer meist in Europe/Berlin umrechnen.

Zusammenfassung

Das Verbinden von Calendly mit Webhooks ist dank moderner Tools wie Make/Zapier in unter 5 Minuten erledigt. Für Entwickler bietet die API v2 volle Kontrolle über Organisationen und User-Events.

Du hast Probleme? Überprüfe in den Calendly-Einstellungen unter "Integrations", ob dein API-Token noch aktiv ist!

0