UnlockOS — Google Calendar Integration
Write-only calendar integration for double-booking prevention at hourly-rental and overnight-stay facilities
Overview
UnlockOS provides keyless check-in infrastructure for hourly-rental and overnight-stay facilities. Operators commonly publish their inventory across multiple channels (Spacemarket, Instabase, Spacee, Airbnb, etc.), each of which polls the facility’s Google Calendar to detect availability. By writing UnlockOS direct reservations to Google Calendar in real time, UnlockOS blocks the same slot from being booked through other channels, preventing double-bookings.
Requested scope
https://www.googleapis.com/auth/calendar.events
Why: UnlockOS writes confirmed reservations to the facility’s calendar as blocking events, updates them when modified, and deletes them on cancellation. UnlockOS does not read calendar contents.
Actions performed
- Events.insert — create a blocking event for each new reservation
- Events.update — update event times when a reservation is modified
- Events.delete — delete the event when a reservation is cancelled
Actions NOT performed
- CalendarList enumeration
- Reading or modifying events created by third parties
- Push notifications / Webhooks for event subscription
- Writing to personal calendars beyond the operator-selected one
Data handling
- Stored: OAuth refresh token (encrypted in Supabase vault), target calendar ID, facility identifier
- Not stored: event content, third-party PII, any other data from Google Calendar
- Recipients: only the facility’s authorised Google Calendar. UnlockOS does not share or sell this data to third parties.
- Retention: refresh token is deleted within 30 days after the integration is disconnected.
How to disconnect
- In UnlockOS admin → Settings → Google Calendar Integration → "Disconnect"
- Alternatively, revoke UnlockOS access via Google Account → Security → Third-party apps
- After disconnection, UnlockOS will stop creating events and the stored refresh token will be deleted within 30 days
Onboarding
In the UnlockOS admin panel, navigate to Settings > Google Calendar Integration and click Connect. You will be redirected to Google’s OAuth consent screen and asked to choose the destination calendar (defaults to primary). Typical setup time is under one minute.
Failure handling
On API failure, the admin panel displays a re-authorisation banner and notifies the facility operator. Reservations remain in their confirmed state regardless (key issuance is unaffected).
Contact
Questions about scopes or data handling: ken.okamoto@blockchainlock.io.