Booking Pages

Create a booking page

Create a public scheduling link for a calendar. An agent creates the page, then shares the returned booking_url with a human; when the human picks a slot, a confirmed event is created on the calendar and an event.created webhook fires with a booking_page_id correlation field.

post/v1/booking-pages

Request

  • Base URL: https://api.chronary.ai
  • URL: https://api.chronary.ai/v1/booking-pages
  • Auth: HTTP bearer

Request body

calendar_idstring required
titlestring required
descriptionstring
duration_minutesinteger
buffer_minutesinteger
window_daysinteger
min_notice_minutesinteger
timezonestring
activeboolean

Response

Booking page created

idstring required
org_idstring required
calendar_idstring required
agent_idstring nullable required

Owner agent of the bound calendar; null for shared/org calendars.

slugstring required

Unguessable public token in the hosted URL.

titlestring required
descriptionstring nullable required
duration_minutesinteger required
buffer_minutesinteger required

Padding added before and after each existing event when computing slots.

window_daysinteger required

How far ahead bookings are allowed.

min_notice_minutesinteger required

Minimum lead time before a bookable slot.

timezonestring required
availability_constraintsobject nullable required

Weekly working hours; null = any time inside the window (calendar events still block).

activeboolean required
bookings_countinteger required

Number of bookings made through this page.

booking_urlstring uri required
created_atstring date-time required
updated_atstring date-time required

Example response

{
  "id": "bkp_01H9X4M2P5R8T6V0",
  "org_id": "5f8e...",
  "calendar_id": "cal_01H9X4M2P5R8T6V0",
  "agent_id": "agt_01H9X4M2P5R8T6V0",
  "slug": "a1b2c3d4e5f6g7h8i9j0k1",
  "title": "Intro call",
  "description": "A 30-minute intro chat.",
  "duration_minutes": 30,
  "window_days": 14,
  "timezone": "America/Los_Angeles",
  "availability_constraints": {
    "mon": {
      "start": "09:00",
      "end": "17:00"
    }
  },
  "active": true,
  "bookings_count": 3,
  "booking_url": "https://api.chronary.ai/book/a1b2c3d4e5f6g7h8i9j0k1",
  "created_at": "2026-07-14T10:00:00.000Z",
  "updated_at": "2026-07-14T10:00:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.