External Integrations Help
Overview
The External Integrations page is a hub that lists all UnlockOS integrations with external services as cards. Each card links to a dedicated integration settings page.
Currently supported:
- neppan! — Site controller (two-way sync of reservations and inventory)
- Google Calendar — Write UnlockOS reservations to Google Calendar to prevent double-booking across channels
- CIV Camera — Network camera integration for identity verification at check-in
Beds24, Airbnb direct, and other OTA adapters will be added to this hub in the future.
How to access
Connection Settings → External Integrations tab
Cards
Each provider card shows:
| Element | Description |
|---|---|
| Icon | Provider icon |
| Name | Provider name |
| Description | One-line summary of the integration |
| Status badge | Current connection state (see below) |
| Button | "Connect" or "Manage" |
Status badges
| Badge | Meaning |
|---|---|
| ✓ Connected | Authenticated and operating normally |
| ○ Not connected | Not yet connected. Click the card to start the connection flow |
| ⚠ Reauthorization required | Authentication has expired. May have been revoked on the provider side. Reconnect needed |
| … Checking | Status is being fetched |
Status is distinguishable by color, symbol, and aria-label — not color-only, so it is accessible to users with color vision deficiencies.
Actions
Clicking the card body or the button navigates to the dedicated provider settings page.
- Not connected → connection flow (OAuth consent / API credential input, etc.)
- Connected → change settings, disconnect, view sync log, etc.
FAQ
Q: The tab is not visible
A: If the tab_integrations feature flag is OFF, the External Integrations tab is hidden. Ask a Platform Admin to enable it.
Q: A provider that I cannot use shows up
A: Each provider is gated by individual feature flags (card_neppan / card_gcal / card_civ_camera). Contact your Platform Admin.
Q: I bookmarked the old URLs (/camera-connection, /google-calendar-connection)
A: Old URLs automatically redirect to the new paths (/integrations/civ-camera, /integrations/google-calendar), so your bookmarks continue to work.