---

Overview

The Omnitec integration with Cloudbeds automatically synchronizes reservations and generates access codes, physical key cards, and digital keys when guests check in. This integration eliminates manual data entry and ensures seamless access management for your property.

Requirements

• An active Cloudbeds account with a user that has API Credentials and Integrations permission
• Door Lock scopes: read:doorLockKey, write:doorLockKey, delete:doorLockKey
• An Omnitec account with OSAccess configured
• Your Cloudbeds Property ID

Setup Instructions

How It Works

Automatic Check-in Processing

When a guest checks in through Cloudbeds:

1. The integration receives a webhook notification from Cloudbeds
2. It creates the reservation in OSAccess with stay dates
3. Keys are issued when Cloudbeds sends doorLockKey/key_requested (key card, access code, or mobile key)
4. Omnihub completes the key record in Cloudbeds with keyCode / mobileId as applicable

Requesting Additional Keys

If you need to generate additional keys (passcodes, digital keys, or re-encode cards) after check-in:

1. Use Cloudbeds' door lock key request feature
2. The integration will automatically generate the requested key type
3. The key status will be updated in Cloudbeds

Check-out and Cancellations

When a guest checks out or a reservation is cancelled:

• All access codes are automatically deactivated
• Rooms are checked out from the access system
• No manual cleanup is required

Door Lock Keys

Keys are completed through the Cloudbeds Door Lock / Key API (not custom fields):

• key_card: physical card via encoder / Agent job
• access_code: passcode returned as keyCode on the key record
• mobile_key: digital key returned as mobileId on the key record

Status lifecycle in Cloudbeds: processing → completed or failed (with errorMessage when applicable).

After connection, Omnihub syncs Door Lock settings (encoders and available key types) using the property plantillas configured in OSAccess.

Troubleshooting

Integration Not Working

If something is not working as expected, please contact Omnitec Support and we will help you right away.

To speed things up, please include:

• What were you trying to do when the issue happened?
• Where did it happen in Cloudbeds, and approximately when?
• Your Property ID and Reservation ID (if available)
• What you expected to happen, and what happened instead
• A screenshot or the exact message shown (if available)

Access Codes Not Appearing

• Ensure the guest has checked in (status = "checked_in")
• Confirm a Door Lock key_requested for access_code reached completed
• Check that the reservation has valid dates and room assignments
• Verify Door Lock scopes are granted on the Cloudbeds app

Physical Cards Not Encoding

• Verify that your physical card encoder is connected and configured
• Ensure the guest has a valid email address (required for some operations)
• Check that the OSAccess reservation was created successfully

Disconnecting the Integration

To disconnect the integration:

1. Go to Cloudbeds Connect and find the Omnitec integration
2. Click "Disconnect" or "Remove"
3. The integration will automatically:
   • Remove all webhook subscriptions
   • Clean up integration settings
   • Disable the app in Cloudbeds

Support

If you need assistance with the integration:

• Check this documentation for common issues
• Review the FAQ page for frequently asked questions
• Review the integration logs for error details
• Contact Omnitec support for technical assistance

---