Join the wishlist

Cal.com

Bring the bookings from your Cal.com account into your app, and let your app book meetings.

Connecting

In Cal.com go to Settings, then Developer, then API keys, and create a key. Copy it right away.

Read your bookings

  • status: Which bookings to list, like upcoming.
  • attendee_email: Only bookings with this attendee email.
  • event_type_id: Only bookings of this event type.
  • after_start: Only bookings starting after this moment, like 2026-08-15T00:00:00Z.
  • before_end: Only bookings ending before this moment.
  • limit: How many bookings per read, 1 to 100.

Answers with: uid, title, start, end, booking_status, attendee_name.

Book a meeting

  • start: When the meeting starts, in UTC, like 2026-08-20T09:00:00Z. Required.
  • event_type_id: Which of your Cal.com event types is being booked. Required.
  • attendee_name: Who the meeting is for. Required.
  • attendee_email: Where the booking confirmation goes. Required.
  • attendee_time_zone: The attendee time zone, like Europe/Istanbul. Required.
  • attendee_phone: A phone number for the attendee, with country code.
  • length_in_minutes: Meeting length, when the event type allows more than one.

Answers with: uid, title, end, booking_status.

Settings

  • Event type: The Cal.com event type your app books when a call does not name one.
  • Time zone: The time zone used for attendees when none is given, like Europe/Istanbul.

What it stores

Bookings (uid, title, start, end, booking-status, attendee-name, attendee-email)

Where it speaks

This connection reaches https://api.cal.com and nowhere else. The hosts are fixed by declaration.

Cal.com · Docs · Tentis