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
Copy your 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 your Key and Password copied from Homhero, head back to Touch Stay to complete the connection.
Go to Integrations.
Find Homhero and click Connect.
Paste your Key and Password into the relevant fields
Click Save.
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.
Touch Stay will automatically import:
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
Once the integration is connected, Homhero automatically sends reservation data to Touch Stay, no extra setup needed. This means you can personalise your guides and guest messages with things like:
Guest names
Arrival and departure dates
Check-in and check-out times
Automatically Mapped Fields
The following fields are ready to use straight away:
Field | Mapping type | Data Type |
{{guest_first_name}} | User/guest custom field | Text |
{{guest_last_name}} | User/guest custom field | Text |
{{arrival_date}} | User/guest custom field | Number |
{{checkin_time}} | User/guest custom field | Time |
{{checkout_time}} | User/guest custom field | Time |
{{departure_date}} | User/guest custom field | Number |
{{guest_phone}} ⚠️ | User/guest custom field | Number |
{{guest_email}} ⚠️ | User/guest custom field | Text |
⚠️ Availability of phone number and email depends on the OTA's platform the guest used to book.
💡 Learn more in Field Codes Explained
Want to sync more property data?
You can also map additional fields from Homhero things like Wi-Fi details, door codes, parking info, and house rules, so each guide automatically pulls in the right property information.
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.
⚠️ Heads up
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 merge 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 Homhero guest messages
Once the integration is set up, you can add the Touch Stay Guide Link merge field to your Homhero message templates. This allows each guest to automatically receive their own personalised guidebook link, unique to their reservation and personalised with their details.
To create a new automated message in Homhero, see Adding a New Correspondence Template
For instructions on adding merge fields to your messages, see Merge Fields
For additional help and support creating message automations in Homhero, please reach out to Homhero support.
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.
Step 9. What to expect in Message Hub
Once your reservations are syncing from Homhero, head to Message Hub → Invitations to see everything in one place.
Every confirmed booking from Homhero will automatically create an invitation record here. For each one you'll see:
Guide: the property the booking is for
Guest name, email and phone
Arrival date
Created date: when the invitation record was generated
Views: how many times they've opened it
Last viewed: the date they last opened the guide
If you're using Message Hub templates
Any active message templates will be attached to the invitation record automatically. You'll be able to see at a glance which messages are scheduled to go out and when.
If you're sharing the guide link through Homhero (Step 8)
You'll still see an invitation record created for every booking, but no message templates will be attached. The guide link is being sent from Homhero instead, so Message Hub is just keeping a record.
Tracking guest engagement
Once a guest opens their guide link, the invitation record updates to show:
Last viewed: the date they last opened the guide
Views: how many times they've opened it
This is a useful way to check whether guests have actually looked at the guide before they arrive.
Customising your columns
By default you'll see the most common columns, but you can add more to suit how you work. Click the ⋮ icon in the top-right corner of the Invitations table and select Choose Columns.
Booking Source
If you add the Booking Source column, you'll be able to see at a glance where each booking came from: Airbnb, Booking.com, direct, and so on.
Copying a guest's guide link
Need to share a guide link directly with a guest? Click the ⋮ icon on any invitation row and select Copy link. You can then paste it into any message or email.
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.
🤝 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.
