This guide explains how to connect Hostaway, sync your properties, manage synced information, and troubleshoot common issues.
What Does the Hostaway Integration Sync?
The Hostaway integration supports a complete property portfolio sync with real-time updates.
Depending on the supported listing information, this may include:
Property details
Listing title
Pricing
Availability and blocked dates
Address
Photos
Descriptions
Other supported listing information
Changes made to supported information in Hostaway are automatically reflected on Vidle Housing.
Benefits of Connecting Hostaway
Complete Property Portfolio Sync
Import your Hostaway properties directly to Vidle Housing without manually recreating each listing.
Automated Calendar Synchronization
Availability and blocked dates automatically sync from Hostaway to Vidle Housing, helping keep calendars accurate and reduce the risk of reservation requests for unavailable dates.
Automatic Listing Updates
Changes to supported listing details in Hostaway—including titles, pricing, availability, addresses, photos, and descriptions—are automatically reflected on Vidle Housing.
How to Get Your Hostaway API Credentials
Before connecting Hostaway to Vidle Housing, you'll need your Hostaway Account ID and API Key.
To find or create these credentials:
Log in to your Hostaway dashboard.
Go to Settings → Hostaway API.
Generate a new API token or use an existing one, when applicable.
Click Create API Key to generate a new API key.
Enter a name for the API key.
Select VidleHousing as the Partner.
Copy your Account ID and API Key.
Important: Store your API Key securely. You may not be able to view it again after leaving the page.
Never share your API Key publicly or with anyone who doesn't need access to your integration.
How to Connect Hostaway to Vidle Housing
Once you have your Account ID and API Key:
Log in to your Vidle Housing Host Dashboard.
Go to Listings → Integrations.
Find Hostaway.
Click Connect.
Enter your Hostaway Account ID and API Key.
Complete the connection process.
Once successfully connected, you're ready to begin syncing your properties.
How to Sync Your Hostaway Properties
After connecting your account:
Return to the Hostaway integration page on Vidle Housing.
Click Sync to begin the sync process.
Your properties will begin syncing automatically.
The process may take a few minutes.
You'll receive a notification when the sync is complete.
Review the Sync Status section to check the status of your properties.
Once synced, imported properties should appear under:
Listings → My Listings
What Should I Do After My Properties Sync?
After the sync is complete, review each imported property for accuracy.
Check:
Listing title and description
Photos
Property address
Bedrooms, beds, and bathrooms
Amenities
Monthly pricing
Cleaning and pet fees
Calendar availability
House rules
Check-in instructions
Listing status
Some Vidle Housing-specific information may need to be added manually before a listing can be published.
If the Publish button is gray, hover over it to see which required information is missing.
Managing Pricing for Hostaway Listings
Hostaway can sync pricing information to Vidle Housing.
If your property rents nightly on other platforms, the synced nightly rate may be used to calculate a monthly price on Vidle Housing. For example, a nightly rate may be multiplied by 30 to create an estimated monthly rate.
This may not always reflect the monthly price you want to offer healthcare travelers.
To use your own monthly price:
Go to Listings → My Listings.
Update the listing with your preferred monthly rate.
Go to Account → Sync Settings.
Lock Pricing.
Once Pricing is locked, future syncs should no longer overwrite the monthly rate you've set directly on Vidle Housing.
Managing Other Synced Information
If you want to manage certain supported information directly on Vidle Housing instead of continuing to receive updates from Hostaway:
Go to Account → Sync Settings.
Review the available synced fields.
Lock the information you want to manage directly on Vidle Housing.
Unlocked information may continue to update based on changes made in Hostaway.
Where Should I Update My Calendar?
For Hostaway-connected properties, keep your availability accurate in Hostaway.
Blocked and unavailable dates from Hostaway will automatically sync to Vidle Housing.
If you manually update availability directly on Vidle Housing, a future Hostaway sync may overwrite those changes.
Keeping your Hostaway calendar current helps prevent double bookings and reservation requests for unavailable dates.
Can Hostaway Listings Use Instant Booking?
Yes. Eligible Hostaway listings may use Instant Booking once all requirements are met.
The property must have:
Approved host identity verification
Connected Stripe payout setup
Monthly pricing configured
Published and active listing status
Once Instant Booking is enabled, eligible traveler reservations are automatically approved and confirmed. No additional host approval is required.
My Hostaway Properties Aren't Appearing. What Should I Do?
First:
Confirm you entered the correct Account ID and API Key.
Confirm VidleHousing was selected as the Partner when creating the API key.
Return to the Hostaway integration page and click Sync.
Review the Sync Status section.
Allow a few minutes for the sync to complete.
Refresh Listings → My Listings.
If your properties still don't appear, contact our Support Team.
My Hostaway Connection Isn't Working
If you're unable to connect:
Confirm you're using the correct Hostaway Account ID.
Confirm the API Key was copied correctly.
Make sure there are no extra spaces before or after the credentials.
Confirm VidleHousing was selected as the Partner.
If you're unsure whether the API Key is correct, you may need to create a new one through Hostaway.
Remember that Hostaway may not display an API Key again after it has been created, so make sure to save it securely.
My Hostaway Calendar Isn't Updating
First:
Confirm the dates are correctly blocked or available in Hostaway.
Confirm the correct Hostaway property is connected to the matching Vidle Housing listing.
Refresh your Vidle Housing dashboard.
Allow time for recent changes to sync.
Review Sync Status for available errors or updates.
If the Hostaway calendar is correct but Vidle Housing continues to display incorrect availability, contact our Support Team.
My Listing Information Is Incorrect After Syncing
If information such as your title, pricing, photos, description, or other property details doesn't match Hostaway:
Confirm the information is correct in Hostaway.
Review Account → Sync Settings for locked fields.
Refresh the Vidle Housing listing.
Allow time for recent changes to sync.
If the information remains incorrect, contact our Support Team and provide the affected listing name and screenshots when available.
My Pricing Keeps Changing
If your monthly price keeps reverting after you edit it, Hostaway may still be syncing pricing information.
To manage your monthly price directly on Vidle Housing:
Go to Account → Sync Settings.
Lock Pricing.
Return to your listing and enter your preferred monthly rate.
If your pricing continues to change after Pricing has been locked, contact our Support Team for assistance.
If your Hostaway integration isn't working correctly after basic troubleshooting, contact our Support Team and provide:
Your Vidle Housing account email
Affected listing name
Clear description of the issue
What you expected to happen
What actually happened
Screenshots or screen recordings, when available
Our Support Team can help troubleshoot the issue and create a technical support ticket when further investigation is needed.
