⚠️ Availability: the Rental Wise integration isn't generally available yet. For most accounts, the Rental Wise card on the Partners tab shows "Coming soon" instead of a Connect button. If you'd like to use it, contact us at [email protected].
Connect your Touch Stay and Rental Wise accounts to import Rental Wise property & booking data into your guides and make it easier to share guides with your guests.
Table of contents:
Step 1. Connect your accounts
To get started, you'll need your Rental Wise API key.
1️⃣ Log into your Rental Wise account, click your name on the bottom left part of the page, and click API Access.
Click Add New.
Give your token a name (for example, Touch Stay).
Click Save.
Copy the Token. ⚠️ Rental Wise will only display the key once, so make sure to save it before closing the window!
2️⃣ Next, in Touch Stay, go to Integrations in the left sidebar and open the Partners tab.
Click Connect under the Rental Wise logo.
Paste your Rental Wise token, and then click Save.
Step 2. Match Properties
Once authorised, you can match your existing Touch Stay guides to your Rental Wise listings.
Go to the Integrations page and click the Match tab.
Use the drop-down menus to select the correct Rental Wise listing for each Touch Stay guide.
When you're done, click Match Selected to confirm.
💡 If you don't see any guides listed in this step, you can move straight on to Step 3. Import Rental Wise properties.
Step 3. Import Properties
If you have any remaining unmatched listings from Rental Wise, you can import them directly into Touch Stay.
Go to the Integrations page and click the Import tab.
Tick the listings you want to import.
Click Import Selected to continue.
Touch Stay will import the following details automatically:
Property name
Property address
Cover photo (if the image size meets our requirements)
Each imported listing will create a new Touch Stay guide.
💡 Note about cover photos
Only images that meet our quality requirements can be used as cover photos. A desktop cover photo must be landscape and at least 1920 x 1080 px. A mobile cover photo must be portrait and at least 680 x 1080 px. If the imported image is too small, you may need to upload a different one manually.
How to check or add a cover photo
New Hub: open the guidebook and go to its Appearance tab to check or change the cover photo.
Legacy Hub: go to the Guides page, click your guide name, open the Guide Details tab, go to Guide Cover Photos and click Edit Desktop photo. Click Select Photo, search for the property or guide name in the Filter photos field, select an image and click Save.
💡Tip
The cover photo will automatically be resized to fit mobile view. If you prefer, you can also upload a separate portrait-oriented image to improve how the guide looks on mobile devices.
Step 4. Complete guide creation (new Touch Stay customers only)
Matching or importing your listings won't automatically start syncing bookings from Rental Wise.
Before enabling the sync, take a moment to review your guides and make sure all the content is ready to share with guests.
💡 New to Touch Stay?
Visit our Quick Start Video for helpful tips on the quickest way to build your digital welcome book.
Step 5. Personalisation settings
You can map Rental Wise booking data fields to your Touch Stay custom fields.
This allows you to automatically personalise your guides and guest messages for each booking, for example, by showing the guest's name or stay dates inside your welcome book.
Automatically Mapped Fields
The following Rental Wise booking fields are automatically linked to standard field codes in your Touch Stay account:
Field | Data Type |
Guest first name | Text |
Guest last name | Text |
Arrival date | Number |
Departure date | Number |
Guest contact phone number ⚠️ | Number |
Guest contact email address ⚠️ | Text |
⚠️ Note: Some OTAs or booking sites don't always provide the guest's phone number or email address, so these details may vary depending on where the booking came from.
Optional Fields You Can Manually Map
These additional Rental Wise booking fields are available through the integration and can be manually mapped to your own Touch Stay custom fields:
Field | Data Type |
Number of Adults | Integer |
Total Guests | Integer |
Guest Notes | Text |
How to Map Custom Fields
Go to the Integrations page.
Open the Map data tab.
Click Add new mapping.
Select the Rental Wise field you want to connect.
Choose a name for your custom field code and, if needed, add a substitute value.
💡 Tip: Substitute values are used when data from custom fields is missing at the time the field code is used. For example, if a custom field, such as Number of adults, isn't provided, you could display a message like "Contact us if this information is missing."
👉 Learn more in our article: Field Codes Explained
Once your custom fields are mapped, any future bookings synced from Rental Wise will automatically populate those fields on the Touch Stay Invitation record.
💡 Tip: You can then use this data in your Message Hub templates and guide content to personalise the guest experience.
⚠️ Note: Once a Rental Wise field has been mapped, it will no longer appear in the "Add new mapping" dropdown. To make changes, edit the existing mapping on the Map data tab instead: click the three dots next to it and select View/Edit. See Edit, replace or remove a data mapping below.
Editing an Existing Mapping
If you need to update the substitute value or adjust the text for a field that has already been mapped:
Go to Account library → Field Codes (legacy Hub: Settings → Field Codes).
Click the three dots next to the field code.
Select Edit to update the substitute value.
Edit, replace or remove a data mapping
Your existing mappings are listed on the Map data tab of the Integrations page. Use the three dots next to a mapping to change or remove it.
To edit a mapping:
Click the three dots next to the mapping and select View/Edit.
In the Edit data mapping window, choose a different custom field. The Rental Wise field itself can't be changed. To map a different Rental Wise field, remove this mapping and add a new one.
For property-level fields, such as Number of Bedrooms, you can also switch Choose mapping type between Guide custom field and Topic customisation. For a topic, select it under Select Touch Stay topic and choose a rule under Set visibility override rule.
Click Save.
Each Rental Wise field can be linked to one custom field or topic, and each custom field or topic can be linked to one Rental Wise field. If you save a mapping for a field that's already mapped, or pick a custom field or topic that's already linked to another Rental Wise field, the old mapping is replaced. A Rental Wise field that loses its mapping this way shows up again in the Add new mapping list.
To remove a mapping:
Click the three dots next to the mapping and select Delete.
Click Delete to confirm.
This removes the connection between Rental Wise and Touch Stay for that field. The custom field or topic itself isn't deleted.
Step 6. Sync bookings
Sync Rental Wise bookings with your Touch Stay account and complete the integration.
Go to the Sync Reservations tab on the Integrations page (legacy Hub: Sync bookings).
Choose how to import your bookings:
All bookings – recommended if you're new to Touch Stay. This will sync all your future-dated bookings and generate invitations for each one.
New bookings only – choose this if you already use Message Hub to send invitations. It will only create invitations for bookings made after the sync activation date, preventing duplicates.
Tick the checkboxes for the guides you want to sync — Select all is at the top, next to Sync Selected.
Click Sync Selected. The process may take a few minutes, depending on the number of bookings and properties. You can stay on the page or continue working; the sync runs in the background.
Once active, any new Rental Wise bookings will automatically import into Touch Stay for those guides.
💡 Tip: You can view imported bookings any time under Messaging & Chat → Invitations (legacy Hub: Message Hub → Invitations).
Step 7. Sharing guide links through Rental Wise
Touch Stay automatically sends a unique guide link for each booking back to Rental Wise.
You can include this link in your Rental Wise Booking Automations to share guides automatically.
Your Rental Wise account will now have a new custom booking field: {{ts_guidebook_url}}
💡 How to add this custom booking field to your Rental Wise Booking Automations
Go to Inbox > Message Templates.
In the Booking Templates tab, click Create Template.
In the Plain Text Message field, type in {{records.custom_fields.ts_guidebook_url}}
Go to Automation > Booking Automations, and then click Create Automation.
On the workflow time trigger, make sure to have at least an hour after the record is created.
In the Workflow action, select Send a message to the main guest, and then select the template you created.
Finally, hit Save.
Best Practice: Sharing Your Guide
A note about Rental Wise message timing
There may be a short delay between a booking arriving in Rental Wise and the guide link being returned from Touch Stay while both systems process the data.
💡 Recommendation: avoid adding the {{records.custom_fields.ts_guidebook_url}} field to messages that send immediately after a booking is received. Instead, schedule a message about 1 hour later (or even the next day) to introduce your guests to everything they'll find in your guidebook.
When and how to share the Touch Stay guide link (via Rental Wise)
We usually recommend this setup for the best guest experience:
First message – after booking confirmation
When: Around 1 hour after the booking
Why: Avoids sending the guide too early and ensures everything is ready
Reminder message – before arrival
When: A few days or weeks before arrival
Why: Encourages guests to review house info and plan ahead
Final reminder – close to arrival
When: 1 day before arrival
Why: Ideal for check-in instructions and arrival details
What happens if I'm already using Message Hub?
If you want to switch from Message Hub to Rental Wise for sending guide links:
Archive your existing Message Hub message templates; this stops them from being added to new bookings.
Set up your new Rental Wise 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:
1️⃣ Matching not completed
Each time you add a new listing to your Rental Wise account, you'll need to complete the matching and sync steps in Touch Stay for it to share guide links automatically.
2️⃣ Sync not activated
Check that syncing is enabled for the property on the Integrations → Sync Reservations tab. If the property isn't selected for syncing, no guide links will be sent back to Rental Wise.
💬 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
Rental Wise booking ID
This information helps our team investigate the issue quickly.
🤝 Need help?
Our Fin AI assistant is available 24/7 and typically responds in under 10 seconds. If Fin isn't able to solve your issue, our support team will take ownership of your case from there.
You can also reach out to our team at [email protected], and we'll be happy to help.