April 2026 - Action Required: Migrate Your Door Lock Integration to the Cloudbeds Keys API

We're excited to announce that Cloudbeds has launched a new dedicated Access Management & Door Lock experience — a purpose-built UI and API that replaces the legacy Custom Fields-based integration approach.

This upgrade represents a significant step forward for both your integration and your mutual customers, and we're asking all door lock and access management partners to complete migration to the new API by Sept 1, 2026.

What's changed:

Previously, door lock integrations relied on Cloudbeds Custom Fields to pass key data back and forth — a workaround that was never purpose-built for access management. The new approach gives you a first-class API and a dedicated UI within the Cloudbeds reservation view.

Benefits of the new integration:

• Purpose-built Key API - A dedicated /keys endpoint and webhook events (doorLockKey/key_requested, doorLockKey/key_cancelled) purpose-built for access management, replacing fragile Custom Field workarounds. • Support for all key types - Natively supports Keycards, Access Codes, and Mobile Keys within a single consistent framework, giving your customers flexibility in how they manage access. • Real-time status visibility - Key records surface directly in the Cloudbeds reservation view with live status (Processing, Completed, Failed), so hotel staff always know the state of a key without leaving the PMS. • Improved error handling - Failed key issuance can now surface a clear, human-readable error message directly in the UI, reducing front desk confusion and support escalations. • Room mapping support - Doorlock IDs can be mapped to Cloudbeds room definitions and retrieved via the getRooms endpoint, eliminating manual workarounds for mismatched room names. • Webhook-driven architecture - Room assignment and key invalidation events (reservation/accommodation_changed) let your integration react in real time to room reassignments, cancellations, and multi-room reservations without polling. • Better guest experience - Access codes and mobile key URLs are surfaced directly in the reservation view and can be sent from Cloudbeds via email or other GX message channel, making it easy for staff to share them with guests at the right moment.

How to get started:

Full integration documentation and step-by-step blueprints for each key type are available here: https://developers.cloudbeds.com/docs/doorlocks-via-api

Documentation on enabling key delivery messages is available here: https://developers.cloudbeds.com/docs/doorlocks-via-api

To enable the new UI for your demo and Marketplace Application, please reach out to [email protected]

Migration deadline: Sept 1, 2026

After this date, the Custom Fields-based integration path will no longer be supported. We encourage you to begin planning your migration now to ensure a smooth transition for your shared customers.

If you have any questions or need support during migration, don't hesitate to reach out to our Partnerships team.

Best regards, Ben Mouw, Cloudbeds Partnerships Team