Calendars - Sorraia API

A calendar widget is an embeddable booking widget bound to a verified domain. Calendars are read-only in v1.

{
  "id": 44,
  "name": "Discovery call",
  "domain": { "id": 5, "domain": "example.com" },
  "bookingCount": 12,
  "settings": { "slotDuration": 30 },
  "appearance": {},
  "behavior": {},
  "createdAt": "2026-05-01T12:00:00.000Z",
  "updatedAt": "2026-05-18T08:00:00.000Z"
}

List responses include bookingCount; the single-widget view adds settings, appearance, and behavior. Any webhook URL inside settings is stripped from API responses.

List calendar widgets

GET /v1/calendar-widgets — scope read:calendars. Supports page, limit, and domainId.

curl https://api.sorraia.app/v1/calendar-widgets \
  -H "Authorization: Bearer sor_live_xxxxxxxx"

const result = await sorraia.calendars.listCalendarWidgets({});

GET /v1/calendar-widgets/{id} — scope read:calendars.

curl https://api.sorraia.app/v1/calendar-widgets/44 \
  -H "Authorization: Bearer sor_live_xxxxxxxx"

const widget = await sorraia.calendars.getCalendarWidget({ id: 44 });

To read a calendar’s bookings, see Bookings.