Hostaway Integration

Connecting your Hostaway account with StayFi

Hostaway is a fast, flexible vacation rental software which provides direct booking websites, channel management, and a full suite of short term rental management tools to homeowners and property managers. StayFi’s integration with Hostaway lets Hostaway users import their guest list into StayFi and use StayFi’s internal email and text marketing tools to stay in touch with past guests. Hostaway users can also use StayFi’s wifi splash pages to collect the contact information of every guest, not just the booker, thereby growing their guest list quicker and having a more complete idea of who is staying at their properties.

The integration also makes it easy to import properties into StayFi for faster onboarding, and adds additional functionality like dynamic occupancy alerting to StayFi's guest tracking capabilities. The following document outlines the setup and functionality of the integration.

Table of Contents


Connecting your Hostaway Account with StayFi

Connecting your Hostaway account to StayFi will let you import your Hostaway properties and contacts into StayFi. This will help you keep track of all of guests and reservations in one place, keep property information consistent between platforms, and enable functionality like dynamic occupancy alerting. Hostaway contacts can also be added to StayFi's email marketing tool to help you stay in touch with past guests.

You will be taken through an onboarding flow which walks you through connecting your PMS to StayFi and importing properties and contacts from your PMS when you first create a StayFi account. If you didn't connect your Hostaway account with StayFi initially, follow the instructions below to get started.

1. Find Your Hostaway Account ID

In your Hostaway account, go to Settings, select Account, and find your Account ID on the left.

Screen Shot 2022-12-08 at 6.54.21 PM

2. Generate a Hostaway API Key

In your Hostaway account, go to Settings, select Hostaway API, click Create, and name the API Key StayFi.

Screen Shot 2022-12-08 at 6.49.25 PM

3. Paste Your Account ID and API Key Into StayFi

In StayFi, go to Integrations, select Hostaway, paste your Hostaway Account ID and API Key into the appropriate fields, and click Connect.

Screen Shot 2022-12-08 at 7.08.33 PM


Importing Hostaway Properties into StayFi

Adding properties in StayFi helps keep track of where guests are logging in from and where different wifi access points are located. Tracking properties correctly will make sure data is tracked cleanly, and will let you personalize any marketing messages based on where each guest stayed.

Importing your Hostaway properties into StayFi will make onboarding quicker, lead to fewer mistakes, and will ensure that guest data gets assigned to the right spot in your PMS. This also helps maintain consistency between both systems.

Before importing Hostaway properties into StayFi, you will need to create a splash page and create property groups. Once you've done this, head to the Properties page and select Import Properties from PMS:

You will now see a list of properties from your Hostaway account with the option to select which group you'd like to assign them to in StayFi. Assign each property to a group or select "Don't import" from the dropdown menu. Once all properties have been assigned a group, select Import Properties at the bottom of the page:

All selected properties will be imported into the appropriate group in your StayFi account. New Hostaway properties can be added using the Sync with PMS button, and selecting "Import new properties" at any point:


Linking Existing StayFi Properties With Hostaway

If you've already manually created properties in StayFi, you can link your existing StayFi properties with the corresponding property in Hostaway. Linking properties is preferred over creating new properties in StayFi as it will preserve all splash page settings and guest data that has already been collected. Make sure your Hostaway account is already connected to StayFi before going through the following steps.

From the Properties page, click "Sync With PMS" and select "Update Existing Properties" from the dropdown menu:

Using the dropdown, select which Hostaway property each of your StayFi properties should link with and click Link Properties. Select "Don't link to PMS property" for any StayFi properties you don't want to link. In this example, "StayFi Property" will be linked with the "Cool Place" property in Hostaway:

An orange lightning bolt icon will show up next to the name of any properties that have been linked with Hostaway. All linked properties will keep their original name in StayFi:


Importing Historic Hostaway Contacts to StayFi

Once your Hostaway account is connected to StayFi, all new contacts collected in Hostaway will automatically be imported into your StayFi guest list going forward. Importing historic contacts lets you track all guest information in one place, and adds contextual booking information to your StayFi guest list. Imported contacts will also be added to your email marketing subscriber list once the email marketing tool is turned on in StayFi, enabling you to send marketing campaigns to all contacts from one place.

If you are setting up your StayFi account for the first time, the onboarding flow will walk you through importing your Hostaway contacts into StayFi. If you skipped this step or want to import additional contacts, head to the Guest List page and select Import PMS Guests in the top right corner:

On the following page you'll see a sample of what data will be imported from Hostaway. The date range dropdown lets you select which guests you'd like to import from Hostaway. "All Time" will import all guests, whereas "Past Year" will only import guests that were added to Hostaway in the last year:

Contacts imported from Hostaway will appear in your Guest List with the fields seen above. Use the Filter Rows dropdown to filter contacts based on whether they were imported from your PMS, and use the Hide / Show Columns dropdown to choose what information is displayed in the table. Guests can be searched by name, email, phone number, property, or property group in the search bar at the top:


Using Hostaway Contacts in StayFi's Email Marketing

StayFi's email marketing tool makes it easy to send subscribers one-time email campaigns, or enroll them in automated emails journeys. This is a great way to build brand awareness and stay in touch with past guests who might rebook your property in the future. Once you turn on email marketing, all contacts from your StayFi Guest List who opted into email marketing will be added to your Email Marketing Subscribers list. Make sure to import your historic Hostaway contacts into StayFi to be able to market to them through the Email Marketing tool.

After activating email marketing from the Email Marketing page in StayFi, make sure to select Import Existing Contacts during the onboarding process. If you don't do this during onboarding, you can import contacts at any point by selecting More > Settings and Billing > Import Contacts.

After you've imported contacts once, all future guests will automatically be added to your Email Marketing Subscribers under the "StayFi PMS Guests" list. The following fields will automatically be filled out for all Hostaway contacts imported into StayFi:

  • Source
  • Arrival Date
  • Departure Date
  • Book Date
  • Property
  • Property Group

These fields, along with their corresponding "last" / "next" fields which show the same information for previous and future bookings can be used to segment contacts, trigger automations, and dynamically insert content into your email marketing campaigns.

Refer to our Email Marketing setup document for more information on setting up email marketing in StayFi.


Dynamic Occupancy Alerts

Occupancy alerts have traditionally been used to send email notifications if more unique guests than a certain threshold connect to the wifi at the same time. While this is invaluable for identifying when guests exceed the maximum occupancy of the property, it doesn't identify when guests exceed the occupancy reported on their reservation.

With Hostaway connected, you can set dynamic occupancy alerts for your properties, where the occupancy threshold for the alert becomes the number of guests listed on the reservation. This way if the maximum occupancy for the property is 8, but the reservation was made for 4 people, you will still receive an occupancy alert if 5 unique guests connect to the wifi at the same time. Dynamic occupancy alerts can be particularly helpful for seeing which guests misreport occupancy if you charge extra person fees for your property.

To set dynamic occupancy alerts, head to the Properties page in StayFi and select Set Here under the Occupancy Threshold column, or select the three dots on the right and click Edit:

Turn on the Occupancy Alerts toggle and check the box next to "Set occupancy threshold dynamically via Hostaway". Set a fallback threshold which will be used as the default threshold if StayFi cannot find a current reservation for the property. Select an alert recipient and click update:

Occupancy alerts will now be emailed to the alert recipient whenever guests exceed the occupancy of their reservation.


Please send any questions about the Hostaway integration or Email Marketing in StayFi to support@stayfi.com