Connect Touch Stay with Homhero to automate your guest communication. Import properties, sync reservations, personalise your guidebooks with Homhero data, and automatically share personalised guidebook links with your guests.
This guide explains how to set up the integration step by step.
Step 1: Get your Homhero API credentials
Before connecting Homhero to Touch Stay, you'll need to activate the Touch Stay integration in Homhero and copy your API credentials.
In Homhero, click Marketplace from the left-hand menu
Locate and select the Touch Stay Icon
Turn the Active toggle on
Key - Copy the key
Under Password, click the eye icon to reveal the password, then copy it.
Property Fields - The ''Touchstay Guide Link'' will automatically generate for you under Property Management / Properties / Booking Fields
Click Save
Step 2: Connect Homhero to Touch Stay
Once you have copied your Key and Password from Homhero, return to Touch Stay to complete the connection.
In Touch Stay:
Go to Integrations.
Find Homhero and click Connect.
Paste your Homhero Key into the Key field.
Paste your Homhero Password into the Password field.
Click Save.
Once connected, you'll be ready to import your properties and start syncing reservation data between Homhero and Touch Stay.
Step 3. Match Homhero properties
If you already have guides in Touch Stay, you'll now match them to the correct properties in Homhero.
Go to Integrations
Click the Match tab.
Use the dropdown next to each Touch Stay guide to select the matching Homhero property.
Click Match Selected.
Take a moment to double-check your matches before continuing. This helps ensure the correct property information and reservations sync to the right guide.
Don't have any guides to match?
No problem. If you're creating new guides from your Homhero properties, skip this step and move on to the Import tab
Step 4. Import Homhero properties
If you have any Homhero properties that haven't been matched to an existing Touch Stay guide, you can import them as new guides.
Go to Integrations
Click the Import tab.
Select the Homhero properties you'd like to import.
Click Import Selected.
💡 Good to know
Only unmatched Homhero properties will appear in the Import tab.
Once imported, a new Touch Stay guide will be created for each selected property and will appear on your Guides page.
Each imported guide will automatically include key information from Homhero, including:
Property name
Property address
Property location
This helps you get started more quickly, with the basic property information already added to your guide.
Step 5. Complete guide creation (for new Touch Stay customers only)
Before enabling the sync, take a moment to review your guides and make sure everything is ready to share with guests. This includes checking your:
Guide content
Property information
Check-in instructions
Contact details
Images and branding
💡 New to Touch Stay?
Visit our Quick Start Video for helpful tips on the quickest way to build your digital welcome book.
Step 6. Personalisation settings
Homhero can automatically send reservation data to Touch Stay, allowing you to personalise your guides and guest messages. For example, you can display:
Guest names
Arrival and departure dates
Check-in and check-out times
Contact details
This data can be used in your guide content and Message Hub templates
Automatically Mapped Fields
The following Homhero reservation fields are automatically available in Touch Stay and do not require any additional setup:
Field | Mapping type | Data Type |
Guest's first name | User/guest custom field | Text |
Guest's last name | User/guest custom field | Text |
Arrival date | User/guest custom field | Number |
Check-out time | User/guest custom field | Time |
Check-in time | User/guest custom field | Time |
Departure date | User/guest custom field | Number |
Guest contact phone number ⚠️ | User/guest custom field | Number |
Guest contact email address ⚠️ | User/guest custom field | Text |
⚠️ Some OTAs and booking sites do not always provide the guest's email address or phone number; the availability of these two data points depends on the platform the guest used to complete their booking.
Optional Fields You Can Map Yourself
Homhero also provides a number of additional data fields through the integration that can be manually mapped to Touch Stay custom fields.
If you'd like to bring even more property information into your guides for advanced personalisation, take a look at our article:
Examples of Homhero Fields You Can Map
Field | Mapping type | Data type |
Description | Guide custom field | Text |
Lockbox Code | User/guest custom field | Text |
Access Code | User/guest custom field | Text |
Number of adults | User/guest custom field | Number |
Number of children | User/guest custom field | Number |
Number of infants | User/guest custom field | Number |
Number of pets | User/guest custom field | Number |
Reservation notes | User/guest custom field | Text |
Arrival notes | User/guest custom field | Text |
Departure notes | User/guest custom field | Text |
Review | User/guest custom field | Text |
How to Create a Custom Mapping
Go to Integrations
Click the Map Data.
Select the Homhero data field you'd like to sync
Choose an existing custom field, or click + New Custom Field to create one. If creating a new custom field:
Enter a Field Code. When creating a new field code, consider adding _homhero to the end of the name (for example, description_homhero). This makes it easier to identify where the data is coming from.
(Optional) Add a Substitute Value to display when data is missing.
Click Save.
💡 Substitute Value
A substitute value acts as a fallback when information is missing. For example, you create a field for Number of Adults.
If Homhero doesn't provide this information for a reservation, Touch Stay can display your substitute value instead. Examples:
Contact us if this information is missing
Not provided
Please ask your host
This helps avoid blank fields appearing in your guides or guest messages.
💡 Learn more in Field Codes Explained.
Using Your Mapped Data
Once a field has been mapped, you can use it throughout Touch Stay, including:
Topic content
Under the Field Codes button, you'll find all the data available through the Homhero integration, including guest details, arrival and departure dates, check-in and check-out times, and any optional fields you've mapped from Homhero.
This allows you to create a more personalised guest experience without manually updating information for each reservation.
Step 7. Sync reservations
Sync Homhero reservations with your Touch Stay account to complete the integration.
Go to Integrations
Open the Sync Reservations tab.
Under Sync Options, choose how you'd like reservations to be imported:
All reservations (recommended if you're new to Touch Stay)
Imports all future reservations from Homhero.
Creates invitations for all imported reservations.
New reservations only (recommended if you're already using Message Hub invitations)
Only imports reservations created after the sync is enabled.
Helps prevent duplicate invitations.
Select the guide(s) you want to sync.
Use Select All to enable syncing for all guides.
Click Sync Selected.
Once the Sync Reservation is active, new confirmed reservations from Homhero will automatically be imported into Touch Stay for the selected guides.
💡Good to know
The initial sync may take a few minutes, depending on the number of properties and reservations being imported.
You can continue using Touch Stay while the sync runs in the background.
⚠️ Whenever you add a new guide and connect it to a Homhero property, you'll also need to enable Sync Reservation for that guide.
If Sync Reservation is not enabled, reservations will not be imported, and invitation links will not be created for guests staying at that property.
Step 8. Sharing guide links through Homhero
Once reservation syncing is enabled, Touch Stay automatically creates a custom field in Homhero called:
👉 bookingfields.touchstay_guide_url
This field contains a unique, trackable guidebook link for each reservation.
Use the guide link in your guest messages
You can add the Touch Stay Guide Link custom field to your automated messages in Homhero, allowing guests to receive a personalised guidebook link for their stay.
💡If you need help creating or editing automated messages in Homhero, please contact the Homhero Support team.
A note about Homhero message timing - Important
There may be a short delay between a booking being received in Homhero and the Touch Stay Guide Link being generated and synced back to Homhero.
⚠️ Important
Don't include the Touch Stay Guide Link in messages sent immediately after a booking is received.
Instead, send your guidebook message at least 1 hour later, or even the following day, to ensure the personalised guide link is ready.
Best Practices for Sharing Your Guidebook
We recommend the following message schedule for the best guest experience:
After booking confirmation
When: Around 1 hour after the booking is confirmed.
Why: Gives Touch Stay time to generate the personalised guide link before it's sent.
Before arrival
When: A few days or weeks before arrival.
Why: Reminds guests to review important information and plan for their stay.
Day before arrival
When: 1 day before arrival.
Why: A final reminder with check-in instructions, access details and everything guests need before they arrive.
What happens if I’m already using Message Hub?
If you want to switch from Message Hub to Homhero for sending guide links:
Archive your existing Message Hub message templates; this stops them from being added to new reservations.
Set up your new Homhero message flow.
Archiving won’t affect any existing invitations.
To cancel messages already scheduled, delete the Message Hub template instead.
FAQs
Why isn’t my new property sharing the guide link with bookings?
There are a couple of common reasons for this:
Matching not completed
Each time you add a new listing to your Homhero account, you’ll need to complete the matching and sync steps in Touch Stay for it to share guide links automatically.
👉 Step 3. Match Homhero properties
Sync Reservation not activated
If your guide link isn't being sent back to Homhero, first check that Sync Reservations is enabled for the property.
Go to Integrations.
Open the Sync Reservations tab.
Check that the property is selected for syncing.
💬 Still not seeing the link?
If you’ve completed the steps above and the link is still missing, please email [email protected] with:
Your login email address
Guide name
Guest arrival date
Homero booking ID
This information helps our team investigate the issue quickly.
I updated a custom field in Homhero, but I can't see the changes in Touch Stay
Property data is automatically synced from Homhero to Touch Stay every 24 hours.
If you need the changes to appear sooner, you can manually trigger a sync:
To update all guides
Go to Integrations → Map Data and click Resync Guide Data.
To update a single guide:
Go to Guides → Guide Details → Guide Custom Fields, click Edit, then select Resync Homhero Data.
This will refresh the latest property data from Homhero.
💬 Still not seeing the updated data?
If you've completed the steps above and the changes still aren't appearing in Touch Stay, please contact [email protected] and include:
Your login email address
Guide name
The custom field name
When the field was updated in Homhero
A screenshot of the value in Homhero (if possible)
🤝 Need Help?
If you have any questions or need help setting things up, just get in touch.
Or send us a support ticket directly from your Touch Stay account.
