Capability

Cal.com Scheduling

Check availability, list event types and bookings, and create or cancel Cal.com bookings from Synap. New bookings and cancellations follow your approval rules. Needs a Cal.com API key.

What your agent can do with it

  • cal_comAuthenticated HTTP access to the Cal.com API v2. The applier injects the vaulted API key into the Authorization header as `Bearer <key>`; its credentialRef is remapped to the runt…
  • cal_list_bookingsLists upcoming Cal.com bookings (uid, title, start, end, status, location, meeting/video URL, attendees). No args.
  • cal_get_bookingFetches full detail for ONE Cal.com booking by uid — attendees, start/end, status, location, meeting/video URL, and the booking-form responses. Args: { uid: string }.
  • cal_get_slotsReturns available booking slots for an event type within a date range. Args: { eventTypeId: number|string, start: string (YYYY-MM-DD or RFC3339), end: string, timeZone?: string (d…
  • cal_list_event_typesLists the connected user's Cal.com event types. No args.
  • cal_meReturns the authenticated Cal.com user profile. No args.
  • cal_create_bookingCreates a Cal.com booking and notes it as an event entity (proposal-gated). Args: { start: string (RFC3339), eventTypeId: number|string, name: string, email: string, timeZone?: st…
  • cal_cancel_bookingCancels a Cal.com booking by uid and notes the cancellation (proposal-gated). Args: { uid: string, cancellationReason?: string }.

What you will need

Asked for at install. Stored in your pod, never on our servers.

  • Cal.com API keyThe Cal.com API key (Settings -> Developer -> API Keys, a `cal_live_...` token). Stored server-encrypted in the vault; never persisted in the template.
  • {{name}} Cal.com API keySecretCal.com API v2 key for the cal_com connector.