Cal.com Connector

Connect Zenmako to Cal.com to manage scheduling and bookings. This enables AI to view available time slots, create and manage bookings, and help coordinate meeting schedules.

Getting Your API Key

Cal.com uses API keys for authentication. Follow these steps to generate one:

Click your profile icon in the bottom left corner

Select Settings

Navigate to Developer in the left sidebar, then click API Keys

Click Create new API key

Give your key a descriptive name (e.g., "Zenmako Integration")

Optionally set an expiration date, or leave it empty for no expiration

Click Create

Copy the API key immediately (it will only be shown once)

Store your API key securely. The key has access to your Cal.com account data, including bookings and event types.

Connecting Cal.com

Navigate to the Connections page in Zenmako

Click Add Connection and select Cal.com

Enter your credentials:

- API Key: Paste the API key you generated

Click Save

Click Test Connection to verify the setup works

If the test succeeds, your Cal.com connection is ready to use.

Available Actions

Action

Description

getAllBookings	Get all bookings with optional filters (status, attendee, event type, date range)
getBooking	Get booking details by UID
createBooking	Create a new booking for an event type
cancelBooking	Cancel an existing booking with an optional cancellation reason
rescheduleBooking	Reschedule a booking to a new time
confirmBooking	Confirm a pending booking that requires confirmation
getAllEventTypes	Get all available event types configured in your account
getEventType	Get details for a specific event type by ID
getAvailableSlots	Get available time slots for booking within a date range
getAllSchedules	Get all availability schedules
getSchedule	Get details for a specific schedule by ID

Example Prompts

Try these prompts to interact with your Cal.com data:

"Show me all my upcoming bookings for this week"

"What time slots are available for my 30-minute meeting next Tuesday?"

"Cancel the booking with John Smith and let him know I have a conflict"

"Get me a list of all my event types and their durations"

"Reschedule my 2pm meeting tomorrow to 4pm"

Common Issues

"Invalid API key" or "Unauthorized" error

This typically means your API key is invalid or has expired. Solutions:

Verify you copied the complete API key without extra spaces

Check if the API key has an expiration date that has passed

Generate a new API key in Cal.com settings if needed

Unable to create bookings for certain event types

Some event types may have restrictions on who can book. Solutions:

Verify the event type is set to "public" or allows the booking method you are using

Check that the event type has available time slots within your requested time range

Ensure required custom fields are being provided in the booking request