agendly

Agendly API

Integrate appointment bookings, scheduling polls, and calendar functions into your application.

Base URLhttps://agendly.de/api/v1
FormatJSON

Quick Start

1

Load Event Types

Get all available appointment types from an organization.

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

Check Availability

Query available time slots for a specific period.

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

Create Booking

Create a booking for the selected time slot.

POST /api/v1/bookings

Embed Widget

Embed the booking form directly into your website.

Basic Embed

Add this code to your website to display the booking form.

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

With Redirect

Redirect users to your own confirmation page after booking.

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

Styling Options

Customize the appearance of the embedded widget with query parameters.

ParameterEffect
borderless=trueRemoves borders and shadows from the card
noPadding=trueReduces padding for a more compact layout
hideHeader=trueHides the colored header with logo and event info
transparent=trueMakes the background 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

React to booking events in your application 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 Reference