Documentation · Integrations
Connect Google Calendar
Pair your Google Calendar with LiteHQ so confirmed bookings and tours appear as events. Covers connecting, what syncs, backfill on reconnect, and reconnecting.
Pairing Google Calendar puts your LiteHQ bookings and tours on the same calendar you already live in. Once you connect a Google account, confirmed bookings and scheduled tours show up as events on that calendar, and your guests get a native Google invite they can accept or decline. This guide walks operators (hosts) and tenant admins through connecting an account, choosing which bookings sync, and what to do when a connection lapses.
The pairing is per user, not per workspace: you connect your own Google account, and the access tokens are stored encrypted in our token vault, never visible to other members. You can pair more than one account, and you can disconnect at any time.
Before you start
Calendar sync settings live in your workspace under Settings, Calendar sync (the URL is /w/your-slug/settings/calendar-sync). The Integrations hub also lists Google Calendar under Productivity; its Manage button just redirects to the same Calendar sync settings page.
You need to be a host admin or owner (or a tenant admin) to change calendar settings. The connect/disconnect controls themselves act on your own Google account.
- Where to go: Settings, Calendar sync.
- Who can do it: host owner/admin, or tenant admin.
- What you connect: your personal Google account (you can pair more than one).
The connection is tied to your user, and the encrypted tokens never leave our vault. The settings page only ever shows connection metadata (the paired email, status, and last sync time), never the tokens themselves.
Step 1 · Connect your Google account
On the Calendar sync page, find the Google Calendar pairing card and click Connect Google Calendar. If you have already paired an account, the same button reads Pair another account.
You are sent to Google's standard sign-in and consent screen, where you choose which Google account to use and approve LiteHQ's request to manage events on your calendar. LiteHQ requests only the calendar.events scope (the ability to create and update events), plus your email address so the settings page can label which account you paired. It does not request the ability to read or manage your other calendars.
After you approve, Google sends you back to LiteHQ and the paired account appears in the list with an active status. If you cancel on Google's screen or close the window, nothing is connected and you can simply try again.
- Click Connect Google Calendar (or Pair another account).
- Pick the Google account and approve calendar access on Google's screen.
- You land back on the Calendar sync page with the account listed as active.
If you have to sign in again partway through, sign in as the same person you started as. LiteHQ checks that the account finishing the flow matches the one that started it, so a connection is never attached to the wrong profile.
Step 2 · Choose what syncs
Under Add bookings to my Google Calendar you control which confirmed bookings land on your calendar, with three independent toggles. These are saved per workspace, so set them once and they apply to everything that syncs to your connected account.
The defaults are deliberately conservative: external (guest) bookings and tour bookings sync, member bookings do not, until you turn them on. A cancellation always removes a previously-synced event, regardless of these toggles, so your calendar never holds an event for a booking that no longer exists.
- External (guest) bookings: public / guest bookings sync to your calendar. On by default.
- Internal (member) bookings: bookings made by your members sync. Off by default.
- Tour bookings: tours are added to your calendar and the visitor is invited. On by default.
- Cancellations always remove the matching event, even when the toggle is off.
What an event looks like
For a booking, the event uses the booking title (or the resource name) as the summary, includes the room and address in the description and location, and adds the guest as an attendee. For a tour, the summary names the visitor or their company and the visitor is added as an attendee.
Because the guest or visitor is added as an attendee, Google itself sends the calendar invite. They get a real Accept / Decline card in their inbox, and when a booking or tour is moved or cancelled, Google sends the update or cancellation natively. To avoid sending two invites for the same event, LiteHQ suppresses its own .ics email attachment whenever Google has already invited the guest.
If you have not connected Google Calendar, guests still get a calendar invite: LiteHQ falls back to attaching a standard .ics invitation to the confirmation email, and the booking success page always offers Add to Google Calendar and Add to Outlook links. Connecting Google Calendar is what puts the event on your own calendar and lets Google handle the RSVP.
Booking and tour confirmation emails carry a calendar invite even without a Google connection. Pairing Google Calendar adds the operator-side benefit: every confirmed booking and tour also appears on your calendar automatically.
Backfill on reconnect, and the hourly safety net
Live sync only fires at the moment a booking or tour is confirmed or changed. If your connection happens to be down at that moment, that event would otherwise never reach your calendar. Two mechanisms close that gap.
First, when you connect (or reconnect) a Google account, LiteHQ immediately runs a one-off backfill scoped to your workspace. It walks your confirmed, future bookings and upcoming tours that have not yet synced and adds them to your calendar, so the calendar fills in right after you pair rather than waiting for the next change. This also covers a first-time connect, where existing future bookings would otherwise be missing.
Second, a reconciliation job runs every hour as a safety net. It checks every active connection and adds any future, confirmed bookings and tours that are still missing from the calendar. Both paths are future-only (they never clutter your calendar with past meetings), are idempotent (safe to run repeatedly), and add events to your calendar without re-emailing guests who already booked.
- On connect or reconnect: an immediate, workspace-scoped backfill of future, unsynced bookings and tours.
- Every hour: a reconciliation pass that catches anything still missing.
- Both are future-only, idempotent, and do not re-notify guests during backfill.
When a connection lapses, and how to reconnect
Google access can lapse: a token expires or is revoked, or you removed LiteHQ's access from your Google account. When that happens, LiteHQ flags the connection with an error status and stops syncing to it. New bookings and tours will not be added to that calendar until you reconnect.
The Calendar sync page surfaces this clearly. The affected account shows an error badge, and a prominent banner appears reading that calendar sync is paused and that new bookings and tours are not being added to your calendar. Click Reconnect (or Connect Google Calendar again) to re-run the OAuth flow. Reconnecting both restores sync and triggers the immediate backfill, so anything you missed while the connection was down is filled in straight away.
To stop syncing entirely, click Disconnect next to the paired account. Disconnecting removes the pairing; it does not retroactively delete events already on your calendar.
- A lapsed connection shows an error badge plus a paused-sync banner.
- Reconnect re-runs the consent flow and immediately backfills what was missed.
- Disconnect stops future sync but leaves existing events in place.
If you notice bookings are no longer appearing on your calendar, check the Calendar sync page first: an error badge or paused-sync banner means the fix is always to reconnect.
Frequently asked
Do I need a Google connection for guests to get a calendar invite?
No. Booking and tour confirmation emails include a standard .ics calendar invitation even with no Google connection, and the booking success page always offers Add to Google Calendar and Add to Outlook links. Connecting Google Calendar adds the events to your own calendar and lets Google send the native Accept / Decline invite to guests.
Which bookings sync to my calendar?
It depends on the three toggles under Add bookings to my Google Calendar. By default, external (guest) bookings and tour bookings sync, and member (internal) bookings do not until you turn them on. Cancellations always remove a previously-synced event regardless of these settings.
Can other people in my workspace see my Google tokens?
No. The pairing is tied to your user account and the access tokens are stored encrypted in our token vault. The settings page only ever shows connection metadata such as the paired email, status, and last sync time, never the tokens.
What happens to bookings made while my connection was down?
They are backfilled. Reconnecting runs an immediate, workspace-scoped backfill of your future, unsynced bookings and tours, and an hourly reconciliation job catches anything still missing. Both are future-only and do not re-email guests who already booked.
Calendar sync stopped working. How do I fix it?
Open Settings, Calendar sync. If a paired account shows an error badge or you see a paused-sync banner, the connection has lapsed (an expired or revoked token). Click Reconnect to re-run the Google consent flow; that restores sync and backfills anything you missed.
Can I connect more than one Google account?
Yes. Use Pair another account on the Calendar sync page to add additional Google accounts. You can disconnect any of them individually.