Overview
Connect your Hospitable account to CraftedStays to automatically sync your properties, photos, availability, and enable direct bookings on your website.
Prerequisites
Before connecting, make sure you have:
An active Hospitable account
Properties set up in Hospitable
A payout method configured in Hospitable (required for bookings)
Step-by-Step Connection
1. Select Hospitable as Your PMS
When you first sign up or from your dashboard:
You'll see the PMS selection screen
Click on Hospitable
2. Authorize CraftedStays
You'll be redirected to Hospitable's authorization page
Sign in to your Hospitable account if prompted
Click "Authorize" to grant CraftedStays access
You'll be redirected back to CraftedStays
3. Select Properties to Import
After authorization:
CraftedStays will display all properties from your Hospitable account
Select the properties you want to display on your website
Click "Import Selected"
4. Wait for Property Sync
Properties will begin importing immediately
Photos may take several minutes to fully sync
You'll see a status indicator showing sync progress
Enabling the Booking Widget
For guests to book directly through your site, you need to enable the Hospitable
Booking Widget:
1. Verify Payout Method
In Hospitable:
Go to Settings > Payouts
Ensure you have an active payout method configured
The booking widget won't work without this
2. Enable Widget in CraftedStays
Go to your site Settings
Navigate to Hospitable Settings
Enable the Booking Widget
Save changes
What Syncs from Hospitable
Data | Sync Behavior |
Property name | Auto-syncs |
Description | Auto-syncs |
Photos | Auto-syncs (may take several minutes) |
Amenities | Auto-syncs |
Location/Address | Auto-syncs |
Availability/Calendar | Real-time sync |
Pricing | Real-time during booking |
Reviews | Auto-syncs when marked as "show" |
Manual Sync
If you've made changes in Hospitable and want them reflected immediately:
Go to Properties in your CraftedStays dashboard
Click on the property you want to update
Click "Sync Now"
Wait for the sync to complete
Troubleshooting
Properties Not Importing
Problem: You authorized Hospitable but no properties appear.
Solutions:
Make sure you have active properties in Hospitable
Try disconnecting and reconnecting Hospitable
Contact support if the issue persists
Photos Not Showing
Problem: Property imported but photos are missing.
Solutions:
Wait - Photos can take several minutes to sync
Click "Sync Now" on the property
Verify photos are uploaded in Hospitable
Duplicate Properties
Problem: Same property appears twice.
Solution:
Go to Properties in your dashboard
Delete the duplicate entry
Keep the one with complete data
"Unknown provider: null" Error
Problem: Property shows an error message.
Solution:
Delete the problematic property from CraftedStays
Re-import the property from Hospitable
If it persists, contact support
Booking Widget Not Showing
Problem: Property page doesn't show the booking calendar.
Solutions:
Verify payout method is active in Hospitable
Check that Booking Widget is enabled in Settings > Hospitable Settings
Make sure the property has availability in its calendar
Calendar Not Displaying Dates
Problem: Booking calendar shows but no dates are available.
Solutions:
Check availability settings in Hospitable
Verify the property isn't blocked for all dates
Sync the property again
Code Showing Instead of Description
Problem: Property description shows HTML code or placeholder text.
This is usually a temporary sync issue:
Wait a few minutes
Click "Sync Now" on the property
If it persists, contact support
How Bookings Work
Guest visits your CraftedStays website
Guest selects dates and clicks "Reserve" or "Book Now"
Guest is taken through the Hospitable booking widget
Payment is processed by Hospitable
Booking confirmation is sent to guest
Reservation appears in your Hospitable dashboard
Calendar automatically updates on your CraftedStays site
Important: All payments are processed through Hospitable. CraftedStays does not handle payment processing.