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)
- Beds24 — Sync reservations from major OTAs (Booking.com / Airbnb / Expedia / Rakuten / Jalan) in one place
- Cloudbeds — Sync reservations and send key info or a check-in URL back
- Mews — Sync reservations (Mews has no field for writing key info back, so guests check in on UnlockOS)
- Roomboss — Sync reservations and write key info into the booking notes
- 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
- SMS/Voice Notifications (Twilio) — Sending source used for SMS phone verification and for sending unlock keys / voice announcements by SMS
- Fixed Code Lock — Register keypad-style locks whose PIN never changes (Fixed Code Lock)
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 support to enable it.
Q: A provider that I cannot use shows up
A: Each provider is gated by individual feature flags (card_neppan / card_beds24 / card_cloudbeds / card_mews / card_roomboss / card_gcal / card_civ_camera / card_twilio_sms / card_fixed_code). Contact support.
Q: The "Fixed Code Lock" card is not shown
A: card_fixed_code is not yet enabled in production (staging only). Contact support if you would like to use it. See Fixed Code Lock for details.
Q: Mews does not receive the QR code
A: Mews has a dedicated field for door PINs, and UnlockOS writes the PIN there with its validity period. Mews has no equivalent field for QR codes, so the QR cannot be sent. If you want guests to receive a QR code, choose "Check in on UnlockOS".
Q: Will old PINs pile up on the other side?
A: No. When a PIN is reissued, UnlockOS overwrites the value it wrote before rather than appending a new one. For Roomboss booking notes, UnlockOS only rewrites its own section, so anything your staff wrote before or after it is preserved.
Q: The SMS/Voice Notifications (Twilio) card still shows "Not connected" even though I chose the platform sending option
A: This card's status only reflects your own (BYO) Twilio connection. If you chose "Send from UnlockOS" (platform), the card may still show "Not connected". Open the card's settings page (see SMS Phone Verification) to check your actual sending source.
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.