Skip to content
← Public packages

@kentcdodds/cal-com

Cal.com helpers for booking pages, event types, slots, and webhooks.

README.md

36 lines · 1.3 KB · Markdown

@kentcdodds/cal-com

Intent

Cal.com scheduling helpers for booking pages, event types, availability slots, bookings, and webhooks. The REST layer is a thin OpenAPI-scaffolded client against Cal.com API v2, with domain helpers that return parsed/unwrapped JSON and a small booking-page summary.

Use google-products/calendar for direct Google Calendar event CRUD instead of Cal.com booking flows.

What it does

  • Read profile, bookings, event types, available slots, and webhooks
  • Summarize booking pages (username + event-type booking URLs)
  • Create, cancel, or reschedule bookings when you explicitly request it
  • Register Cal.com webhooks for automation
  • Escape-hatch request helper for uncommon Cal.com API v2 paths

Prerequisites / setup

  1. Create a Cal.com API key in the Cal.com developer settings.
  2. Save it in Kody as user secret cal-com-api-key (do not paste the key value in chat).
  3. Approve host api.cal.com if prompted, and approve this package to use cal-com-api-key.
  4. Agents: see AGENTS.md for import paths and smoke checks.

Done when

  • cal-com-api-key is saved; api.cal.com and package secret access are approved
  • Read-only smoke test returns profile and event-type catalog checks
  • Booking / webhook mutations are only run after you confirm the target event, attendee, and times