Uplisting Integration

Connect your Touch Stay and Uplisting accounts to import Uplisting listings & booking data into your guides and make it easier to share guides with your guests.

The steps to complete your integration:

• Step 1: Connect your Touch Stay & Uplisting accounts
• Step 2: Match Uplisting properties
• Step 3: Import Uplisting 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 Uplisting
• A note about Uplisting message timing

Step 1. Connect your accounts

1. Log in to your Uplisting account.

2. Click Settings > Connect

   

3. Locate and click API. Copy the API key.

   

4. On your Touch Stay account, go to Integrations > Uplisting, click Connect, and then paste the API Key from the previous step.

   ✅ This will connect your Uplisting and Touch Stay accounts.

Step 2. Match Properties

Once authorised, you can match your existing Touch Stay guides to your Uplisting properties.

1. Go to the Match tab on the Integrations page.
2. Use the drop-down menus to select the correct Uplisting listing for each Touch Stay guide.
3. When you’re done, click Match Selected to save your matches.

💡 Tip:

If you don’t see any guides listed on this step, don’t worry, you can skip straight to Step 3.

Step 3. Import Properties

If you still have any unmatched listings from Uplisting, you can easily import them into Touch Stay.

1. Go to the Import tab on the Integrations page.
2. Tick the box next to each listing you want to import.
3. Click Import Selected to add those listings to your Touch Stay account.

💡 Tip: Once imported, your new guides will automatically appear in your Guides list and be ready to set up.

What Touch Stay Imports

When you import from Uplisting, Touch Stay will bring in the following details:

• Listing Name
• Listing Address
• Cover Photo

Each unit imported will create a new Touch Stay guide.

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

Matching or importing your listings won’t automatically start syncing reservations from Uplisting.

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 Uplisting listing and reservation data fields to your Touch Stay custom fields or topic customisations.

This allows you to automatically personalise your guides and guest messages for each reservation, for example, by showing the guest’s name or stay dates inside your welcome book.

The steps below explain how to map and sync reservation data from Uplisting to your Touch Stay account.

If you’d like to learn how to map listing data (for deeper guide-level personalisation), see our related article: Guide level data mapping with Uplisting

Automatically Mapped Fields

The following Uplisting reservation fields are automatically linked to standard field codes in your Touch Stay account:

⚠️ 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 Uplisting reservation fields are available through the integration and can be manually mapped to your own Touch Stay custom fields:

How to Map Custom Fields

1. Go to the Integrations page.
2. Open the Map Data tab.
3. Click + Add New Mapping.
4. Select the Uplisting field you want to connect.
5. 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 or Number of children, isn’t provided, you could display a message like “Contact us if this information is missing.”
     • 👉 Learn more in our article: Field Codes Explained
6. Once your custom fields are mapped, any future reservations synced from Uplisting 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.

Step 6. Sync reservations

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

1. Go to Integrations → Sync tab
2. Under Sync Options, choose how to import your reservations:

   • All reservations – recommended if you’re new to Touch Stay.

     This will sync all your future-dated reservations and generate invitations for each one.

   • New reservations 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.

3. Tick the checkboxes for the guides you want to sync. Use Select All (top-right) to choose all guides at once.
4. Click Sync Selected.
   • The process may take a few minutes, depending on the number of reservations and properties.
   • You can stay on the page or continue working; the sync runs in the background.
5. Once active, any new Uplisting reservations will automatically import into Touch Stay for those guides.

💡 Tip:

You can check your sync status or view imported reservations anytime from the Message Hub →  Invitations page.

Step 7. Sharing guide links through Uplisting

Touch Stay automatically sends a unique guide link for each reservation back to Uplisting.

You can include this link in your Uplisting message templates to automatically send guides to guests through the Uplisting Automation.

Your Uplisting account will now include a new custom reservation field called:

{{ts_guide_link}}      

To set up your Uplisting messages:

1. Go to Automate, and then click New message rule.

   

2. On the new rule, go to Content, write your message, position your cursor to where you want your guide link to appear, and then click the ts_guide_link button under Custom booking attribute tags.

   *Please note that the content field will show {{booking.ts_guide_link}}

3. Scroll down to the Scheduling section, and set it to the following details: 1 hr after booking . On the Properties section, check all the listings. Finally, hit 'Save Rule'.

   

And that’s it! You can now include the Touch Stay guide link in your Uplisting message templates to automatically share your welcome book as part of your guest communication flow.

Notes:

A note about Uplisting message timing

There may be a short delay between a booking arriving in Uplisting and the guide link being returned from Touch Stay while both systems process the data.

💡 Recommendation:

Avoid adding the {{booking.touchstay-guide-link}}       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.

What happens if I’m already using Message Hub?

If you want to switch from Message Hub to Uplisting for sending guide links:

1. Archive your existing Message Hub message templates; this stops them from being added to new reservations.
2. Set up your new Uplisting message flow.

3. Archiving won’t affect any existing invitations.

   To cancel messages already scheduled, delete the Message Hub template instead.