Cloudbeds Integration
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:
- Go to Settings → Integrations → Cloudbeds
- Click Connect Cloudbeds
- 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?
- Check that the OAuth connection is still active in Settings
- Verify the property mapping is correct
- 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.