Guesty for Pros Integration

6 min. readlast update: 05.08.2024

Please note this integration is for customers with a Guesty Pro account. If you have a Guesty Lite account, read this article instead.


The steps to complete your integration:

  • Step 1: Connect your Touch Stay & Guesty accounts
  • Step 2: Match Guesty properties
  • Step 3: Import Guesty properties
  • Step 4: Complete guide creation (new Touch Stay customers only)
  • Step 5: Personalisation settings
  • Step 6: Sync reservations
  • Step 7: Sharing guide links through Guesty

Connect your Touch Stay and Guesty Pro accounts to import Guesty property & reservation data into your guides and make it easier to share guides with your guests.

Step 1. Connect your Touch Stay & Guesty accounts

You will need your Guesty Integration Token to get started. Login to your Guesty Pro account and click on Integrations > Guesty Marketplace. Use the search box on the left to search for 'Touch Stay'. Click 'Connect' on the Touch Stay logo then click the 'Connect' button at the upper right of the screen to reveal your Guesty Integration Token. Copy the token.

Next, come back to Touch Stay go to Integrations and click Connect under the Guesty logo. Select Guesty Pro from the pop up menu and then 'Connect'.

Paste your Guesty Integration Token into the box and click 'Save'.


Step 2. Match Guesty listings

You can now match existing Touch Stay guides to your Guesty properties. Go to Integrations > Match and use the drop-downs to match the correct Guesty property for each Touch Stay guide. Touch Stay allows matches to standalone units, multi-units and sub-units. Use the checkbox to reveal sub-units, if required.

When matching multi-units, any reservations for sub-units which don't have their own dedicated guide, will generate invitations for the parent multi-unit guide. When the matching is complete, click 'Match selected'. 


Step 3. Import Guesty properties

If you have any remaining unmatched properties from Guesty, go to Integrations > Import. Click the remaining properties you want to import and click ‘Import selected’. The units that can be imported are either standalone units, multi-units or sub-units. Use the checkbox to reveal the sub-units, if required.

When importing multi-units, any reservations for sub-units which don't have their own dedicated guide, will generate invitations for the parent multi-unit guide.

Each imported property will create a new Touch Stay guide and populate them with the following details from Guesty:

  • Property Name
  • Property Address
  • Property Location

Step 4. Complete guide creation (for new Touch Stay customers only)

Now is the time to check the content of your guides to make sure they are ready to share with guests before you complete the integration and sync your Guesty reservations.

If you’re new to Touch Stay then check out the Getting Started page for hints and tips on the quickest way to build out your guide content. If you have more than 20 properties, please contact us at to find out more about our onboarding service.

Step 5. Personalisation settings

You can map Guesty property & reservation data fields to Touch Stay custom fields or topic customisations. These can then be inserted into guides and guest messages to personalise them for each reservation. The following paragraphs explain how to map and sync Guesty reservation data to your custom fields or topic customisations.

We have a separate article covering how to map and sync property data for further guide level personalisation.

The following Guesty reservation data fields will be automatically mapped to standard field codes in your Touch Stay account:

  • Guest first name (data type: Text)
  • Guest last name (data type: Text)
  • Arrival date (data type: Number)
  • Departure date (data type: Number)
  • Guest contact phone number* (data type: Number)
  • Guest contact email address* (data type: Text)

*Some OTAs and booking sites do not always provide the guest email address or phone number so the availability of these two data points are dependent on the platform the guest used to complete their booking.

The following Guesty reservation data fields are also available through the integration. They are optional and can be manually mapped to a Touch Stay custom field: 

  • Key Code (data type: Text)
  • Guesty Lock Manager Code (data type: Text)
  • Number of Guests (data type: Number)
  • Property ID (data type: Text)
  • Property Title (data type: Text)
  • Confirmation Code (data type: Text)
  • Reservation Custom Fields (various data types)

To connect any of these optional data fields to Touch Stay custom fields go to Integrations > Map data and click the '+Add new mapping' button. 

From here you can select the Guesty data field to connect. Choose from an existing custom field or create a new one by giving it a name and any substitute value. Substitute values are used in the case of data missing when the field code is used, see this article for more detail about field codes.

Once the custom fields have been created, any future reservations which sync from Guesty will have the relevant data automatically populated for the reservation (invitation record) and can be used in Memo message templates and guide content.

Step 6. Sync reservations

Sync Guesty reservations with your Touch Stay account and complete the integration.

Here you can choose whether to import all your existing reservations or only import new reservations. 

  • If you are new to Touch Stay and not using the Memo messaging tool then choose 'All reservations'.

  • If you are already using the Memo messaging tool, then choose 'New reservations only'  to prevent duplicate Memo messages being sent to existing reservations.

If you have selected 'All reservations' then all existing reservations from Guesty will now be imported and the unique guide link of each one will be passed back into Guesty.

To complete this step, go to Integrations > Sync reservations and select the guides you want to sync using the checkboxes. Use the ‘Select all’ option to select all in one go. Click 'Sync selected'.


Step 7. Sharing guide links through Guesty

By activating the sync, a data field called touchstay_guide_url will automatically be created in your Guesty account. This data field contains a trackable guide link that's unique for each reservation.

You can add this data field to an existing or new automated message in Guesty so every guest can access a guide that has been personalised with their reservation details.

You can find instructions explaining how to add this custom field variable into an automated message in Guesty in this article.

Warning:  Do not delete the touchstay_guide_url custom field variable in the Guesty Custom Fields page. If you delete it, you will need to contact Touch Stay support to have it added back in.

For additional help and support creating message automations in Guesty Pro please reach out to Guesty support.

A note about Guesty message timing: there will be a slight delay between the booking arriving in Guesty and the link being sent back from Touch Stay whilst our respective systems process the booking, generate the link and pass it back. Therefore we recommend NOT adding your "Touch Stay Guide Link" custom field to Guesty messages that are sent out as soon as the booking is received. Instead, we recommend adding a message ~1 hour later or perhaps the next day that's dedicated to introducing guests to everything they'll find in your guide book.

Guesty also has a handy guide to best practice when setting up automated messages.





Was this article helpful?