agendly

Agendly API

Integriere Terminbuchungen, Terminumfragen und Kalenderfunktionen in deine Anwendung.

Basis-URLhttps://agendly.de/api/v1
FormatJSON

Schnellstart

1

Event-Typen laden

Hole dir alle verfügbaren Terminarten einer Organisation.

GET /api/v1/organizations/{slug}/event-types
2

Verfügbarkeit prüfen

Frage verfügbare Zeitslots für einen bestimmten Zeitraum ab.

GET /api/v1/availability/{eventTypeId}
3

Buchung erstellen

Erstelle eine Buchung für den gewählten Zeitslot.

POST /api/v1/bookings

Embed Widget

Binde das Buchungsformular direkt in deine Website ein.

Einfaches Embed

Füge diesen Code in deine Website ein, um das Buchungsformular anzuzeigen.

<iframe
  src="https://agendly.de/de/{org}/{event}?embed=true"
  width="100%"
  height="650"
  frameborder="0"
></iframe>

Mit Redirect

Leite Nutzer nach der Buchung auf deine eigene Bestätigungsseite weiter.

<iframe
  src="https://agendly.de/de/{org}/{event}?embed=true&return_url=https://example.com/done"
  width="100%"
  height="650"
  frameborder="0"
></iframe>

Styling-Optionen

Passe das Aussehen des eingebetteten Widgets mit Query-Parametern an.

ParameterEffekt
borderless=trueEntfernt Rahmen und Schatten der Karte
noPadding=trueReduziert das Padding für ein kompakteres Layout
hideHeader=trueVersteckt den farbigen Header mit Logo und Event-Infos
transparent=trueMacht den Hintergrund transparent
<!-- Minimal embed without borders and header -->
<iframe
  src="https://agendly.de/de/{org}/{event}?embed=true&borderless=true&hideHeader=true&transparent=true"
  width="100%"
  height="500"
  frameborder="0"
></iframe>

JavaScript Events

Reagiere auf Buchungsereignisse in deiner Anwendung via postMessage.

window.addEventListener('message', (event) => {
  if (event.origin !== 'https://agendly.de') return;

  if (event.data.type === 'agendly:booking_created') {
    console.log('Booking created:', event.data.booking);
    // { uid, status, attendeeName, attendeeEmail, startTime, eventType }
  }
});

API-Referenz