CloudBeds Integration

Connects via a direct API key. No OAuth flow. One key covers all properties registered under the same Cloudbeds account. CloudBeds official site ↗

Supported features

Feature	Supported	Notes
Hotel availability	✓	Room types, dates, occupancy
Room types	✓
Room rates	✓
Create reservation	✓	Two-step flow; explicit guest confirmation required
List / get reservations	—
Rate plans	—	Used internally only
Payment link	—

Setup steps

Get your API key from Cloudbeds
Log in to the Cloudbeds Marketplace (Apps & Marketplace → API section). Generate an API key scoped to the property you are connecting. Copy the key immediately — it is shown only once.
If you manage multiple Cloudbeds properties, each shares the same API key but needs its own entry in the hotelConfig array.
Find your property ID(s)
In Cloudbeds, navigate to Settings → Property. The property ID is the numeric identifier shown in the URL (/property/12345). You need one entry per property in hotelConfig.
3
Enter the credentials in the business console
Open the business console, select your client, and go to PMS Integration. Choose CloudBeds as the provider and fill in:
- apiKey — paste the key from step 1
- hotelConfig — one entry per property: id (property ID from step 2) and name (display name)
Enable the integration
Toggle Active to on and save. The agent will immediately begin using live CloudBeds data. To enable the agent to create reservations on behalf of guests, also toggle Enable Reservation Creation.

If you need to update your Cloudbeds API key or apply new Maison features to your property, you must uninstall and reinstall the Maison app in the Cloudbeds Marketplace. Updating credentials in the console alone is not sufficient — a fresh installation ensures all feature permissions are re-granted correctly.