> ## Documentation Index
> Fetch the complete documentation index at: https://help.ddriftt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Your Cloudbeds Account to Ddriftt in Minutes

> Connect your Cloudbeds PMS to Ddriftt with a secure Marketplace OAuth flow so properties, availability, rates, reservations, and payments stay in sync.

This guide walks property owners through connecting a Cloudbeds account to Ddriftt so properties, availability, and bookings stay in sync.

## Before you begin

You will need:

* An active Ddriftt property owner account (onboarding completed)
* A Cloudbeds user who can authorize Marketplace apps for the hotel(s) you want to connect
* Access to those properties in Cloudbeds (multi-property accounts import every hotel the authorization covers)

## What gets connected

After a successful connection, Ddriftt will:

* Import your Cloudbeds hotel(s), addresses, and room types
* Sync availability and rates for booking (including arrival/departure restrictions and length-of-stay rules)
* Create reservations in Cloudbeds when guests book on Ddriftt
* Post payments to Cloudbeds after successful guest payment
* Keep cancellations and date changes in sync via Cloudbeds webhooks

## How connection works

Ddriftt uses Cloudbeds' secure authorization flow (Marketplace OAuth). You do not paste API credentials for the standard setup:

<Steps>
  <Step title="Start the connection in Ddriftt">
    You start the connection in Ddriftt.
  </Step>

  <Step title="Approve access in Cloudbeds">
    You are redirected to Cloudbeds to sign in and approve access.
  </Step>

  <Step title="Return to Ddriftt">
    Cloudbeds returns you to Ddriftt and the connection finishes automatically.
  </Step>

  <Step title="Import properties">
    Ddriftt begins importing your properties.
  </Step>
</Steps>

## Start the connection in Ddriftt

<Steps>
  <Step title="Sign in">
    Sign in to Ddriftt as a property owner.
  </Step>

  <Step title="Open PMS Connections">
    Go to **Account → PMS Connections**.
  </Step>

  <Step title="Add a connection">
    Click **Add New**.
  </Step>

  <Step title="Select Cloudbeds">
    Choose **Cloudbeds** as the PMS.
  </Step>

  <Step title="Use the standard connection flow">
    Leave **Beta: connect with manual API key** unchecked (recommended).
  </Step>

  <Step title="Connect">
    Click **Connect with Cloudbeds**. You will be redirected to Cloudbeds.
  </Step>
</Steps>

## Authorize Ddriftt in Cloudbeds

<Steps>
  <Step title="Sign in to Cloudbeds">
    Sign in to Cloudbeds if prompted.
  </Step>

  <Step title="Review permissions">
    Review the permissions Ddriftt requests.
  </Step>

  <Step title="Approve permissions">
    Approve all requested permissions so property import, availability, reservations, and payments can work.
  </Step>

  <Step title="Complete authorization">
    Complete authorization. Cloudbeds then redirects you back to Ddriftt to finish setup.
  </Step>
</Steps>

### Permissions Ddriftt needs

Ddriftt requests access to:

* Read hotel and room information
* Read rates and availability
* Read and write reservations
* Read and write payments

If any of these are missing, reconnect and ensure every permission is granted on the Cloudbeds consent screen.

## Confirm import in Ddriftt

<Steps>
  <Step title="Confirm the connection">
    You should see a confirmation that the connection was added and properties are importing.
  </Step>

  <Step title="Wait for import">
    Wait a few minutes for the import to finish.
  </Step>

  <Step title="Confirm hotels and room types">
    Open your **Properties** list and confirm each expected hotel and room type appeared.
  </Step>

  <Step title="Complete listing details">
    Complete any Ddriftt listing details that were not imported from Cloudbeds (photos, marketing copy, publish settings, and so on).
  </Step>

  <Step title="Refresh if needed">
    If something is missing, return to **PMS Connections** and click **Refresh** on the Cloudbeds connection card.
  </Step>
</Steps>

## Managing the connection

On **Account → PMS Connections**, each Cloudbeds connection card supports:

* **Refresh**: re-import hotels and room types from Cloudbeds
* **Disconnect**: disable the Cloudbeds app connection for linked properties and stop syncing in Ddriftt

You can also disconnect the app from Cloudbeds Marketplace. When Cloudbeds reports that the app was disabled, Ddriftt will mark the connection as disconnected.

### Reconnecting

If you reconnect (for example after fixing permissions), Cloudbeds may ask you to approve permissions again. Approve all scopes so the new connection has full access.

### Multi-property accounts

If your Cloudbeds authorization covers multiple hotels, Ddriftt imports all hotels returned for that connection. Disconnecting the connection in Ddriftt disables the app for each linked property.

If you only want a subset of hotels connected, authorize with a Cloudbeds user/property scope that matches what you intend to import, or contact Ddriftt support for guidance.

## Troubleshooting

| Problem                                              | What to try                                                                                                              |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Authorization canceled / returned without connecting | Start again from **PMS Connections → Add New → Cloudbeds → Connect with Cloudbeds**, and complete approval in Cloudbeds. |
| Connection failed verification                       | Start the flow again in the same browser session (do not bookmark or reuse an old callback link).                        |
| Already connected to another Ddriftt user            | That Cloudbeds account is linked to a different Ddriftt owner. Disconnect there first, or use the correct owner account. |
| Missing permissions / "scope" errors                 | Disconnect in Cloudbeds and reconnect from Ddriftt, approving all requested permissions.                                 |
| No properties or room types imported                 | Confirm the Cloudbeds user can access the hotels, then use **Refresh**.                                                  |
| Availability or booking issues                       | Ensure base (standard) rates are configured and bookable in Cloudbeds for the room types you want to sell.               |
| Credentials no longer valid                          | Reconnect from Ddriftt. Long-idle Cloudbeds API keys can stop working after extended inactivity.                         |

## Tips for a smooth go-live

* Configure room types and base rates in Cloudbeds before connecting.
* Confirm credit/card payment methods are enabled in Cloudbeds so guest payments can post cleanly after booking.
* After connecting, place a test booking (or follow Ddriftt staging guidance) to confirm availability, pricing, reservation creation, and payment posting in Cloudbeds.
* Prefer the standard **Connect with Cloudbeds** flow. The manual API key option is for beta/testing only.

## Need help?

Contact Ddriftt support with:

* Your Ddriftt owner account email
* Your Cloudbeds property name(s)
* A description of the step that failed (and any exact error message shown in Ddriftt)