HiLucyHelp Center

Cloudbeds Integration

HiLucy Team·Updated 2026-04-17·2 min read

HiLucy has a deep, native integration with Cloudbeds — one of the leading Property Management Systems for hotels and vacation rentals.

What Gets Synced

| Data | Direction | Frequency | |------|-----------|-----------| | Reservations | Cloudbeds → HiLucy | Every 15 minutes (cron) | | Guest details | Cloudbeds → HiLucy | With each reservation sync | | Room/unit assignments | Cloudbeds → HiLucy | With each reservation sync | | Check-in/out status | Cloudbeds → HiLucy | Real-time via webhook |

Setup Steps

1. Connect via OAuth

In your HiLucy admin dashboard:

  1. Go to Settings → Integrations → Cloudbeds
  2. Click Connect Cloudbeds
  3. Sign in to your Cloudbeds account and authorize HiLucy

The OAuth connection auto-refreshes tokens, so you never need to reconnect.

2. Map Your Properties

After connecting, map your Cloudbeds properties to HiLucy listings. Each Cloudbeds property ID is linked to a HiLucy listing.

3. Initial Sync

HiLucy runs an initial full sync of all reservations. This typically takes 2-5 minutes depending on your reservation volume.

4. Verify

Check the Reservations page in your admin dashboard. You should see all your Cloudbeds reservations with:

  • Guest names and contact information
  • Dates and room assignments
  • Reservation status

Dual-Write System

HiLucy uses a dual-write architecture for maximum reliability:

  • Reservations are written to both the legacy sync table and the new normalized tables
  • This ensures backward compatibility while enabling new features
  • The system handles conflicts automatically

Monitoring

The sync runs every 15 minutes via WordPress cron. It only logs when there are changes (synced > 0, updated > 0, or errors > 0), keeping your debug log clean.

Troubleshooting

Reservations not syncing?

  1. Check that the OAuth connection is still active in Settings
  2. Verify the property mapping is correct
  3. Check the WordPress debug log for sync errors

Missing guest contact info?

Some OTA bookings (e.g., Booking.com) don't share guest email/phone. These guests will sync without contact info until they provide it directly.

Return to top