PMS Integrations Guide
PMS Integrations Guide
Tier: π± Growth Plan ($29/mo) and above
Time to read: 10 minutes
What are PMS Integrations?
PMS (Property Management System) integrations automatically sync your bookings, guests, and property data from platforms like Lodgify, Hostaway, and Booking.com into GuestLoop.
Benefits:
- No manual data entry
- Bookings sync automatically
- Guest information captured
- Access codes generated
- Guidebook links sent automatically
Supported Integrations
Currently Available
| Platform | Status | Sync Type |
|---|---|---|
| Lodgify | β Active | Full sync |
| Hostaway | β Active | Full sync |
| Booking.com | β Active | OAuth |
| Guesty | π Coming Soon | Full sync |
Integration Capabilities
| Feature | Lodgify | Hostaway | Booking.com |
|---|---|---|---|
| Booking sync | β | β | β |
| Guest data | β | β | β |
| Property sync | β | β | β |
| Revenue data | β | β | β |
| Auto-SMS | β | β | β |
Setting Up Integrations
Accessing Integration Settings
- Go to Dashboard β Settings
- Click "Integrations" tab
- You'll see available integrations
Connection Methods
Different platforms use different connection methods:
| Method | Platforms | How It Works |
|---|---|---|
| API Key | Lodgify, Hostaway | You generate a key in PMS, paste in GuestLoop |
| OAuth | Booking.com | Click Connect, authorize in PMS |
| Webhook | Some platforms | PMS sends data to GuestLoop URL |
Lodgify Integration
Prerequisites
- Active Lodgify account
- Lodgify API access (included in most plans)
- At least one property in Lodgify
Step-by-Step Setup
Step 1: Get Your API Key
- Log in to Lodgify
- Go to Settings β API
- Click "Generate New API Key"
- Copy the key (save it securely)
Step 2: Connect in GuestLoop
- Go to Settings β Integrations
- Find Lodgify and click "Connect"
- Paste your API key
- Click "Verify Connection"
Step 3: Map Properties
- GuestLoop will fetch your Lodgify properties
- Match each Lodgify property to a GuestLoop property
- Or create new GuestLoop properties from Lodgify data
Step 4: Configure Sync Settings
βοΈ Sync bookings automatically (every 15 minutes)
βοΈ Import guest contact information
βοΈ Import booking revenue data
β Auto-send guidebook SMS (configure separately)
What Syncs from Lodgify
| Data | Synced Fields |
|---|---|
| Bookings | Dates, status, source, total price |
| Guests | Name, email, phone, address |
| Properties | Name, address, type |
| Revenue | Total price, currency |
Hostaway Integration
Prerequisites
- Active Hostaway account
- API credentials from Hostaway
- At least one property in Hostaway
Step-by-Step Setup
Step 1: Get API Credentials
- Log in to Hostaway
- Go to Settings β API
- Note your Account ID and API Key
Step 2: Connect in GuestLoop
- Go to Settings β Integrations
- Find Hostaway and click "Connect"
- Enter Account ID and API Key
- Click "Verify Connection"
Step 3: Map Properties
Same process as Lodgify - match or create properties.
What Syncs from Hostaway
| Data | Synced Fields |
|---|---|
| Bookings | All reservation details |
| Guests | Full contact information |
| Properties | Complete property data |
| Payments | Revenue and fees |
Booking.com Integration
Prerequisites
- Booking.com Extranet access
- Property listed on Booking.com
- GuestLoop Business plan (recommended)
OAuth Connection
Unlike API-key integrations, Booking.com uses OAuth:
Step 1: Initiate Connection
- Go to Settings β Integrations
- Find Booking.com and click "Connect"
- You'll be redirected to Booking.com
Step 2: Authorize Access
- Log in to Booking.com if prompted
- Review permissions GuestLoop is requesting
- Click "Authorize"
Step 3: Return to GuestLoop
- You're redirected back automatically
- Connection status shows "β Connected"
- Initial sync begins
What Syncs from Booking.com
| Data | Synced Fields |
|---|---|
| Reservations | Booking details, dates |
| Guest Info | Name, email (when shared) |
| Property | Listing information |
| Revenue | Payout amounts |
Important Notes
- Some guest data may be masked by Booking.com
- Commission rates (15%) are auto-detected
- Sync frequency depends on Booking.com API limits
Sync Orchestrator
How Syncing Works
GuestLoop's Sync Orchestrator coordinates all integrations:
βββββββββββββββββββββββββββββββββββββββββββ
β SYNC ORCHESTRATOR β
βββββββββββββββββββββββββββββββββββββββββββ€
β β
β Lodgify βββ β
β β ββββββββββββββββ β
β Hostaway ββΌββββΆβ GuestLoop β β
β β β Database β β
β Booking βββ ββββββββββββββββ β
β β
β Sync every: 15 minutes β
β Conflict resolution: Latest wins β
β β
βββββββββββββββββββββββββββββββββββββββββββ
Sync Frequency
| Integration | Frequency | Can Customize |
|---|---|---|
| Lodgify | 15 min | β |
| Hostaway | 15 min | β |
| Booking.com | 15 min | β |
Manual Sync
Force an immediate sync:
- Go to Settings β Integrations
- Find your integration
- Click "Sync Now"
Access Codes & Integrations
Automatic Code Generation
When bookings sync from PMS:
- GuestLoop detects new booking
- Generates unique 6-character access code
- Attaches code to booking record
- Code is available for SMS/email
Using Codes in Communications
Your pre-arrival SMS can include:
Hi {guest_name}! Your guidebook for
{property_name} is ready: {guidebook_link}
Access Code: {access_code}
Revenue Tracking
Automatic Revenue Import
Integrations capture booking values:
| Source | What's Captured |
|---|---|
| Lodgify | TotalPrice field |
| Hostaway | Total revenue |
| Booking.com | Payout amount |
Commission Detection
GuestLoop auto-detects OTA commissions:
| Platform | Default Rate |
|---|---|
| Airbnb | 15% |
| Booking.com | 15% |
| VRBO | 10% |
| Direct | 0% |
Revenue Analytics
See your revenue data in:
- Dashboard β Analytics β Revenue
- Property β Revenue tab
- Reports β Revenue Report
Troubleshooting
Connection Issues
"Connection Failed" Error:
- Verify API credentials are correct
- Check PMS account is active
- Ensure API access is enabled in PMS
- Try disconnecting and reconnecting
"Invalid API Key":
- Generate a new key in PMS
- Delete and re-enter in GuestLoop
- Check for extra spaces when pasting
"Rate Limit Exceeded":
- Wait 15 minutes before syncing
- This is temporary
- Automatic sync will resume
Sync Issues
Bookings not appearing:
- Check property mapping is correct
- Verify booking exists in PMS
- Check booking status (cancelled bookings may not sync)
- Try manual sync
Guest data missing:
- Some PMS mask guest data
- Check PMS privacy settings
- Guest may not have provided info
Duplicate bookings:
- Check if booking was manually entered
- Merge duplicate guest records
- Contact support if persistent
OAuth Issues (Booking.com)
"Authorization Failed":
- Clear browser cookies
- Try incognito/private browsing
- Ensure you have property manager access
"Token Expired":
- Go to Integrations
- Click "Reconnect"
- Re-authorize in Booking.com
Managing Integrations
Viewing Status
Integration dashboard shows:
| Status | Meaning |
|---|---|
| π’ Connected | Active and syncing |
| π‘ Syncing | Currently updating |
| π΄ Error | Problem needs attention |
| βͺ Disconnected | Not connected |
Sync Logs
View sync history:
- Go to Settings β Integrations
- Click on integration
- View "Sync Logs" tab
Logs show:
- Sync timestamp
- Records synced
- Errors encountered
Disconnecting
To disconnect an integration:
- Click "Disconnect" button
- Confirm the action
What happens:
- Sync stops immediately
- Existing data is preserved
- Can reconnect later
Best Practices
Initial Setup
- Start with one integration - Get it working before adding more
- Map properties carefully - Mistakes cause duplicate data
- Test with a few bookings - Verify data syncs correctly
- Configure auto-SMS after testing - Avoid sending to wrong guests
Ongoing Management
- Check sync status weekly - Catch errors early
- Review sync logs - Understand what's syncing
- Update API keys if prompted - Some expire periodically
- Keep PMS account active - Integration requires active subscription
Data Quality
- Use PMS as source of truth - Update booking data there
- Don't manually duplicate - Let sync handle it
- Merge duplicates promptly - Keep guest database clean
- Monitor revenue accuracy - Verify imported values
FAQ
Can I use multiple PMS integrations?
Yes, you can connect multiple platforms. GuestLoop will sync from all of them.
What if I have the same property on multiple OTAs?
All bookings sync to the same GuestLoop property. Use property mapping to consolidate.
Do cancelled bookings sync?
It depends on the PMS. Most sync cancellations, and GuestLoop updates the status.
How do I handle manual bookings?
Enter them directly in GuestLoop. They won't conflict with PMS bookings.
What if my PMS isn't supported?
You can import bookings via CSV. Contact us to request new integrations.
Is there a sync delay?
Maximum 15-minute delay from PMS to GuestLoop. Manual sync is instant.
Can I sync historical bookings?
Yes, initial sync imports past bookings (typically last 12 months).
Requesting New Integrations
Planned Integrations
- Guesty (coming Q1 2025)
- OwnerRez (evaluating)
- Hospitable (evaluating)
Request a Platform
- Go to Settings β Integrations
- Click "Request Integration"
- Enter the platform name
- We'll notify you when available
Related Guides
Need More Help?
Can't find what you're looking for? Our support team is here to help!
Contact Support β