Connecting Google Calendar

Connecting your Google Calendar to Leenkies transforms your booking system from a standalone scheduler into a fully integrated part of your daily workflow. With the integration active, your existing calendar events are respected when calculating availability, new appointments automatically appear on your calendar, and video conferencing links are generated without any extra steps.

Three Features Unlocked by Google Calendar

When you connect your Google Calendar, three powerful features become available:

1. Conflict Detection

Leenkies reads your Google Calendar events and automatically removes any time slots that overlap with existing events. If you have a team meeting from 10:00 AM to 11:00 AM on Tuesday, no customer will be able to book a 10:00 AM or 10:30 AM slot on that day. This works for all events on your calendar -- formal meetings, personal appointments, blocked focus time, all-day events, and anything else that appears on your calendar. Conflict detection runs in real time, so even if someone adds a meeting to your calendar five minutes ago, the booking system will reflect it immediately.

2. Automatic Event Creation

When a customer completes the booking process and their appointment is confirmed, Leenkies automatically creates a Google Calendar event at the scheduled date and time. The event includes all the relevant details: the customer's name, email address, any notes they provided during booking, the booking type, and the duration. Both you and the customer are added as attendees, so the event appears on both calendars. You never have to manually enter appointment details into your calendar -- it is all handled automatically.

3. Google Meet Links

If you enable the Google Meet toggle on a booking type (see Creating Booking Types), Leenkies generates a unique Google Meet video conferencing link for each confirmed appointment. This link is automatically attached to the Google Calendar event and included in the confirmation emails sent to both you and the customer. When the appointment time arrives, both parties can join the call with a single click -- no need to create a separate meeting room, share links manually, or coordinate on a video platform.

How to Connect Your Google Calendar

Setting up the integration is straightforward:

1. From your Leenkies dashboard, click Settings in the sidebar navigation.
2. Navigate to the Integrations section within Settings.
3. Find the Google Calendar integration card and click the Connect button.
4. You will be redirected to Google's authorization page, where you sign in to your Google account (or select the account you want to use if you are signed into multiple accounts).
5. Google will ask you to grant Leenkies specific permissions. Review the permissions and click Allow to authorize the connection.
6. You will be redirected back to Leenkies, and the integration card will now show a Connected status with the email address of the Google account you connected.

Permissions Requested

When you authorize the connection, Leenkies requests the minimum permissions necessary to provide the three features described above:

• Read access to your calendar events -- This allows Leenkies to check your existing events for conflict detection. Leenkies reads event times and free/busy status but does not access the full content of unrelated calendar events.
• Write access to your calendar -- This allows Leenkies to create new calendar events when appointments are confirmed. Events are created on your primary calendar with all booking details included.

Leenkies does not request access to your contacts, other Google services, or any data beyond what is needed for calendar integration. The permissions are scoped specifically to Google Calendar.

Pro Tip: If you use multiple Google accounts (for example, a personal account and a business account), make sure you authorize the account whose calendar you actually use for scheduling. The conflict detection and event creation will only work with the connected account's calendar.

Disconnecting Google Calendar

If you need to disconnect your Google Calendar:

1. Go to Settings in the sidebar.
2. Navigate to Integrations.
3. On the Google Calendar card, click the Disconnect button.
4. Confirm the disconnection when prompted.

Once disconnected, the three calendar features stop working immediately:

• Conflict detection no longer checks your Google Calendar (your weekly schedule and existing Leenkies appointments are still respected).
• New appointments will not create Google Calendar events automatically.
• Google Meet links will not be generated for new bookings, even if the toggle is enabled on a booking type.

Existing calendar events that were previously created by Leenkies will remain on your Google Calendar -- they are not deleted when you disconnect. Similarly, any Google Meet links that were already generated and sent to customers will continue to work.

Token Revocation Handling

In rare cases, the connection between Leenkies and your Google Calendar may become invalid. This can happen if:

• You revoke Leenkies' access from your Google Account settings (Security > Third-party apps).
• Your Google account password changes and Google invalidates active tokens.
• Google's security policies flag the connection and require re-authorization.

When this happens, Leenkies detects the invalid token and displays a notification on your Settings page prompting you to reconnect. The notification clearly explains that the calendar integration needs to be re-authorized. Simply click the Reconnect button and go through the authorization flow again to restore the connection.

While the connection is invalid, the booking system continues to work -- customers can still book appointments based on your weekly schedule and existing Leenkies appointments. However, conflict detection against Google Calendar events, automatic event creation, and Google Meet link generation will be paused until you reconnect.

Pro Tip: After reconnecting, you do not need to update any booking types or settings. All your existing configuration (including Google Meet toggles on booking types) is preserved. The reconnection simply refreshes the authorization token so Leenkies can communicate with Google Calendar again.