Skip to main content

Avantio Integration

Touch Stay integrates with Avantio to import your accommodations and then automate the sending of invitations for confirmed bookings. If you don't have a Touch Stay account yet then you can sign up here for a free 14-day trial. Once you have a Touch Stay account, then follow the steps below.

Avantio and Touch Stay

Table of contents:


Step 1. Connect your Touch Stay & Avantio accounts

First, you need to authorise your Touch Stay account with Avantio and will need an API token for this. Avantio support can provide you with your API credentials, reach out to Avantio support and ask for an API auth token to connect to Touch Stay.

Once you have your token from Avantio, go to Integrations in the left sidebar of your Touch Stay account, open the Partners tab and click "Connect" underneath the Avantio logo. Paste your token into the Avantio integration token box and click Save.


Step 2. Match Avantio accommodations

Once authorised, go to the Match tab to pair any existing Touch Stay guides to your Avantio accommodations. Use the drop-downs to select the correct Avantio accommodation for each Touch Stay guide. When complete, click Match Selected. If you don't have any to match, simply move on to the Import tab.

Match tab

Step 3. Import Avantio Units

If you have any remaining unmatched units from Avantio go to the Import tab to import those into Touch Stay. Simply check the ones you want to import and click the Import Selected button. If you don't want to import any, or don't have any remaining, simply move on to the next step.

Import tab

Touch Stay will import the following:

  • Accommodation Name

  • Accommodation Address

  • Accommodation Location

  • Accommodation photos (REST API accounts only; very small images, under 64 px on a side, are skipped)

Each accommodation imported will create a new Touch Stay guide.


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

Matching or importing listings won't automatically start syncing bookings from Avantio, so now is the time to check the content of your guides and make sure they're ready before you sync bookings with Avantio.

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 welcome book content.


Step 5: Personalisation settings

Once you start syncing bookings from Avantio this will bring in data about each booking into Touch Stay and you can use field codes to insert this data into your Message Hub message templates or your guide content for that particular guest. Learn more about using field codes in Field Codes Explained.

The following Avantio reservation data is imported automatically with each booking:

  • Guest first name

  • Guest last name

  • Arrival date

  • Departure date

  • Guest contact phone number*

  • Guest contact email address*

*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 Avantio fields are also available. They are optional and can be mapped to a Touch Stay custom field:

  • Booking Code

  • Adults Number

If your Avantio account uses Avantio's REST API, you'll also see Children Number and Lock Code (booking fields), and Parking Spaces, Wifi Name, Wifi Password, Max Adults and Max Children (property fields).

To connect any of these fields, go to the Map data tab on the Integrations page and click Add new mapping.

Map data tab

From here you can select the Avantio field to connect, choose a name for your custom field code and any substitute value. Substitute values are used in the case of data missing when the field code is used — see Field Codes Explained for more detail about field codes.

Once the custom fields have been created, then any future bookings which sync from Avantio will have the relevant data automatically populated on the invitation record. That data will then show in your Message Hub messages (if you have them) or guide content wherever you have placed the custom field code.


Step 6. Guide sharing options

There are a few ways to get your guide link to guests.

To automatically share a trackable guide link for each booking you can send email or text message guests through Message Hub, Touch Stay's messaging tool. The bookings from Avantio will then follow your message workflow you setup and any default settings as defined by the templates that you create.

See the Message Hub help articles for how to add message templates and create a notification journey for your guests.

Touch Stay also sends each synced booking's guide link back to Avantio, where it's saved in the reservation's external link field.

If you are using Avantio message inbox to communicate with guests you can also copy and paste the relevant guide link into your Avantio message templates using the Quick share link. In the new Hub, open the guidebook, click Invite guests and copy the Quick share link (legacy Hub: the Invite & Share tab on the Guides page).

Quick share link

Step 7. Sync bookings

You can now sync bookings (and your Message Hub messages if you are using them) between Avantio and Touch Stay. Go to the Sync Reservations tab on the Integrations page (legacy Hub: Sync bookings).

Here you can choose whether to import all your future bookings or have Touch Stay only import new bookings. If you are new to Touch Stay then choose All bookings. If you are already a user of Touch Stay messaging before you connect your Avantio account, then it's best to choose New bookings only to prevent duplicate bookings being imported.

Next, select the booking type statuses you want to be imported, this can be "Confirmed" bookings, fully "Paid" bookings or both.

Finally, select the guides you want to sync using the checkboxes — Select all is at the top, next to Sync Selected — and click Sync Selected.

Sync tab

If you have selected "All bookings" then all your future dated bookings from Avantio will now be imported and will generate invitations and schedule email or SMS messages based on the booking details and your Touch Stay message templates. All future bookings for Avantio units matched to Touch Stay guides with the sync active will also now be imported automatically.


Advanced sync options

If you only want some Avantio bookings imported, open Advanced sync options on the Sync Reservations tab.

  • Booking Status to be imported: choose Confirmed or Paid (the default), Confirmed Only or Paid Only.

  • Only bookings with security deposit paid? Choose Yes to import only bookings whose security deposit is paid. Bookings with no security deposit are left out. The default is No.

  • Only bookings with check-in form complete? Choose Yes to import only bookings whose check-in form is complete. The default is No.

Bookings that don't match your choices aren't imported. Your choices are saved when you click Sync Selected or Resync Guides.


🤝 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.

Did this answer your question?