Help Center

Show open times and receive meetings with Cal.com

Show your Cal.com open times on your card and connect Cal.com with an API key so every meeting booked with you lands in your Inbox.

A Book a call block with a public cal.com link shows your open times on the card without any connection. Connect Cal.com with an API key as well, and every meeting booked with you appears in your Inbox with its time, event and booking status, plus Join meeting, Reschedule and Cancel meeting.

Use this guide when

you use Cal.com and want visitors to book from your card, see your next open times at a glance, or keep booked meetings next to your other leads.

Before you start

  • Solo, Team and Business plans include connected schedulers, and so do earlier Starter and Professional plans. The Free plan can still add a booking link, but it cannot connect Cal.com.
  • Only the account owner can connect or disconnect Cal.com. Work in your Personal workspace.
  • Have at least one event type in Cal.com. Any Cal.com plan works, including the free one, because API keys are part of every plan.

Steps

  1. In Cal.com, open Settings, then Developer, then API keys. Create a key and copy it.
  2. Open Settings, choose Integrations, then Scheduling.
  3. On the Cal.com card, paste the key into Cal.com API key and choose Connect with API key. The card then says Connected and lists your event types.
  4. Open the card you want to use, choose Add block, then Book a call. Paste your Cal.com link and choose Create.
  5. Open the new block, pick your event type under Cal.com event type, choose an option under Open as, then choose Update and publish the card.
Cal.com card, connected, with Refresh event types and the opened details listing three event types and Disconnect Cal.com.
  1. Your Cal.com event types. Pick one of these in a Book a call block.
  2. Refresh event types after you add or change an event type in Cal.com.
Once Cal.com is connected, its card shows the account, how many event types it has and when they were last refreshed, with the list under Details.

Zapped stores your API key encrypted and only reads your profile, event types and bookings. It never changes anything in Cal.com, and Cal.com still sends its usual confirmation emails.

Choose how visitors book

The Open as setting on the Book a call block decides what visitors see on your card.

Book a call block settings with a cal.com booking link, the Cal.com event type set to Intro call and Open as set to Open times on the card.
Picking a Cal.com event type fills the booking link and meeting length, and Open as decides what visitors see.
  • Open times on the card: The card lists your next free times. A visitor picks one and your Cal.com page opens on that time, ready for their details. A public cal.com link shows open times even before you connect.
  • Booking page inside the card: Your Cal.com booking page opens in a panel on top of the card, so the visitor never leaves it.
  • Link to the booking page: The button opens your Cal.com page in a new tab.

What visitors see

With open times on the card, visitors pick a day, then a time, shown in their own time zone. See all times opens your full Cal.com page.

Some themes show booking as a plain link. If the block settings say so, choose a theme that supports open times, or keep the link option.

Where booked meetings appear

Once Cal.com is connected, every meeting booked with you on Cal.com appears in your Inbox with the event, the time and Booked through Cal.com, usually within a few minutes. Open it to see the booking status and to use Join meeting, Reschedule or Cancel meeting, which open the booking in Cal.com. You get the same new lead notification as for a form.

If the meeting is cancelled, it shows Cancelled, returns to unread, and a New meeting moves to Closed. History shows Meeting cancelled.

If the meeting is rescheduled, the old meeting closes and History shows Meeting rescheduled. The new time arrives as a new meeting that keeps the card it was booked from and says which meeting it replaced.

Lead page for Priya Shah with a Meeting panel showing the Intro call event, the time, Booked status and Booked through Cal.com.
  1. The Meeting panel shows the event, the time and whether it is still booked.
  2. Join meeting, Reschedule and Cancel meeting open the booking in Cal.com.
A Cal.com meeting opens like any other lead, with its event, time and booking status, plus Join meeting, Reschedule and Cancel meeting.

Refresh or disconnect

After you add or change an event type in Cal.com, choose Refresh event types on the Scheduling page so it appears in the block settings.

Choose Disconnect Cal.com to remove the connection. Booking blocks keep their link, and a public cal.com link keeps showing open times, but they no longer use a Cal.com event type and new bookings stop reaching your Inbox. Meetings already in your Inbox stay there. To fully revoke access, also delete the API key in Cal.com.

Good ways to use this

  • Give the API key a clear name in Cal.com, such as Zapped, so you know which key to delete later.
  • Use open times on the card for a short intro call, so visitors can book in two taps.
  • Name event types clearly in Cal.com, such as 15 minute intro call, because the name appears in your Inbox.

Common questions

Do I need a paid Cal.com plan?

No. API keys are available on Cal.com's free plan, and that is all Zapped needs.

Can my card show open times without connecting?

Yes. A booking block with a public cal.com link shows open times on its own. Connecting adds booked meetings to your Inbox and lets you pick an event type in the block.

Can a team member connect Cal.com for me?

No. Only the account owner can connect or disconnect it. Team members with Inbox access see the meetings booked from the cards they can open.

If something looks wrong

  • If Zapped says the key does not look like a Cal.com API key, copy the whole key again. Cal.com keys start with cal_.
  • If Cal.com rejects the key, check that you copied all of it and that it has not expired in Cal.com, then paste a new key.
  • If Cal.com needs to be reconnected appears, create a new API key in Cal.com and choose Reconnect with a new key on the Scheduling page. Until then, booking blocks keep their link and public open times, but new bookings do not reach your Inbox.
  • If an event type is missing from the block settings, create it in Cal.com, then choose Refresh event types.
  • If the booking page cannot load inside the card, visitors can choose Open in a new tab and book there.

Was this guide helpful?

Still have questions? Contact support and we'll help you out.