Help Center

Show open times and receive meetings with TidyCal

Connect TidyCal with a personal access token so your card shows open times and every meeting booked with you lands in your Inbox.

Connect TidyCal once with a personal access token, then add a Book a call block to any card. Visitors pick a time from the card, confirm it on your TidyCal page, and the meeting appears in your Inbox with its booking type, time and status.

Use this guide when

you use TidyCal 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 TidyCal.
  • Only the account owner can connect or disconnect TidyCal. Work in your Personal workspace.
  • Have at least one booking type in TidyCal. Any TidyCal plan works, including Free.

Steps

  1. In TidyCal, open Integrations, then Advanced, then Manage API keys. Under Personal tokens, create a token and copy it. The token needs no scopes.
  2. Open Settings, choose Integrations, then Scheduling.
  3. On the TidyCal card, paste the token into TidyCal personal access token and choose Connect with access token. The card then says Connected and lists your booking types.
  4. Open the card you want to use, choose Add block, then Book a call. Paste your TidyCal link and choose Create.
  5. Open the new block, pick your booking type under TidyCal booking type, choose an option under Open as, then choose Update and publish the card.

Zapped stores your token encrypted and only reads your profile, booking types and bookings. It never changes anything in TidyCal, and TidyCal 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.

  • Open times on the card: The card lists your next free times for the booking type. A visitor picks one and your TidyCal page opens, where they pick the same time again and add their details, because TidyCal does not accept a time chosen on another site. This needs a connected TidyCal account and a booking type picked in the block.
  • Booking page inside the card: Your TidyCal booking page opens in a panel on top of the card, so the visitor never leaves it. This works without connecting TidyCal.
  • Link to the booking page: The button opens your TidyCal page in a new tab. This works without connecting TidyCal.

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 TidyCal 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.

A published card on a phone with a Book a call block showing days, open times and a See all times link.
On a phone, visitors pick a day and a time from your TidyCal booking type, then confirm it on your TidyCal page.

Where booked meetings appear

Every meeting booked with you on TidyCal appears in your Inbox with the booking type, the time and Booked through TidyCal, usually within a few minutes. TidyCal does not say which card a visitor came from, so Zapped files the meeting under the card whose block uses that booking type. You get the same new lead notification as for a form.

TidyCal does not share links to change a booking, so the meeting shows Open in TidyCal, which opens your bookings in TidyCal. Join meeting appears when the booking type has a video location.

If the meeting is cancelled in TidyCal, it shows Cancelled, returns to unread, and a New meeting moves to Closed. History shows Meeting cancelled. If the time changes in TidyCal, the meeting in your Inbox shows the new time and a note records the change.

Lead page for Marcus Lee with a Meeting panel showing the Intro call event, the time, Booked status and Booked through TidyCal.
  1. The Meeting panel shows the booking type, the time and whether it is still booked.
  2. Open in TidyCal opens your bookings in TidyCal, where you can change or cancel the meeting.
A TidyCal meeting shows its booking type, time and status, and Open in TidyCal takes you to your TidyCal bookings.

Refresh or disconnect

After you add or change a booking type in TidyCal, choose Refresh booking types on the Scheduling page so it appears in the block settings.

Choose Disconnect TidyCal to remove the connection. Booking blocks keep their link, but TidyCal shows open times only through a connection, so blocks that showed open times now open your TidyCal page as a link. New bookings stop reaching your Inbox, and meetings already there stay. To fully revoke access, also delete the token in TidyCal.

Good ways to use this

  • Pick a booking type in every TidyCal block, so each meeting is filed under the right card.
  • Add a video location to the booking type in TidyCal, so Join meeting appears on the meeting in your Inbox.
  • Name booking types clearly in TidyCal, such as 15 minute intro call, because the name appears in your Inbox.

Common questions

Do I need a paid TidyCal plan?

No. Personal access tokens work on every TidyCal plan, including Free.

Why does the visitor pick the time twice?

TidyCal always asks for the time on its own page. The open times on your card show what is free, and the visitor confirms the same time on TidyCal.

Can a team member connect TidyCal 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 token does not look like a TidyCal personal access token, copy the whole token again.
  • If TidyCal rejects the token, check that you copied all of it and that it has not been deleted in TidyCal, then paste a new token.
  • If TidyCal needs to be reconnected appears, create a new token in TidyCal and choose Reconnect with a new token on the Scheduling page. Until then, booking blocks work as links, but open times stop and new bookings do not reach your Inbox.
  • If a booking type is missing from the block settings, turn it on in TidyCal, then choose Refresh booking 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.