🧾Summary

This article details the steps to link your Hostaway account to Aruvo.

🗂️Table of Contents

• When to Use This Guide
• Before You Begin
• Step-by-Step Setup
• Troubleshooting Errors When Linking to Hostaway
  • Invalid or Expired Token Error
• Managing Hostaway Integration
  • Updating Integration Name
  • Deleting an Integration
• Related Articles

🕐 When to Use This Guide

Follow the steps in this article when:

• You've configured your Aruvo account and added at least one property listing
• You need to connect a Hostaway account to Aruvo

✅ Before You Begin

Ensure you have the following ready to ensure an easy setup:

• Aruvo account - If you have not set up your account yet, follow the steps in this article to create and configure your account.
  
• Configure your branding and theme - If you have not completed these steps during initial account setup, follow the steps in this guide to configure your theme and branding.

⚙️ Step-by-Step Setup

1. Open the web portal to Aruvo TV

If you have not created your Aruvo account yet, follow the steps to get started at How To: Create your Aruvo TV account.

2. Navigate to the "Integrations" tab

Click to select the "Integrations" option from the left-side menu.

3. Select the Hostaway PMS integration

Click the button to select the "Hostaway" option from the list.

Tip: Use the "Search" bar to type the name of your PMS and locate it quickly. 

4. Enter integration details

Add your Hostaway account details in the provided fields, then click the "Link PMS" button to connect the integration:

• Integration Name: Enter a display name for your Hostaway integration.

Note that this does not need to match your Hostaway or Aruvo account names. Any display name that helps identify the integration at a glance will be perfect! 

• Account ID: Enter the username/account ID for your Hostaway account.
• Integration Token: Enter the integration API Key code provided by Hostaway.

To generate your Hostaway API Key:

• Log into your Hostaway account dashboard
• Navigate to Marketplace > API
• Follow the steps to enable and generate your API Key and API Secret
  • Note: BOTH the API Key and API Secret will be needed to authorize the connection to Aruvo!
• Copy and paste the API key into the "API Key" field in Aruvo

5. Integration Successful

After confirming the integration was linked successfully, you can import your property listing(s) from Hostaway automatically! Click the "Import Units from PMS" button to proceed with the import, or click the "I'll Do It Later" or "Close" button to skip this step.

6. (optional) Import Unit(s) from Hostaway

Click "Import Units from PMS" to proceed with the import, and the system will collect a list of all units that are set up on your Hostaway account.

• Click the check-box to select individual units to import, or use the "Select All" check-box to select all units.
• You can use the "Search Unit" button to search for a specific property listing.
• If you don't see a property that was recently added to Hostaway, click the "Re-Sync Units" button to refresh the list.
  

Important Note:

• The PMS Sync Status will be "Disabled" by default when you link a PMS Integration on the Aruvo Portal, Sync status should be enabled so that the stay details can sync to the respective property on the Aruvo Portal. 
• You will be able to Import the units from the PMS even if the PMS Sync status is disabled. How to: Turn PMS Stay Syncing On and Off

When you've selected all of the properties that you want to import, click the "Import Units" button to add them to Aruvo.

When the import has completed, Aruvo will display a list of all units that were imported successfully. From here, you can click the "Go To Units Page" button to review the imported properties, and edit any details for individual units if desired.

🛠️ Troubleshooting Errors When Linking to Hostaway

Invalid or Expired Token Error:

If an incorrect or expired API Key is entered when trying to link your Hostaway account, you will receive an error stating "The integration token you provided appears to be incorrect. Please double-check and enter the correct token from your Hostaway account."

How to Fix It:

Follow the steps to generate a new API Key in Hostaway, then copy/paste the new key into Aruvo.

🛠️ Manage PMS Integration

Edit Integration Name

Follow the steps below to update the display name of a PMS integration:

• Navigate to the Integrations Page in Aruvo
• Locate the integration to be updated, and click the "Edit" button next to the integration name

• Enter the new display name in the "Integration Name" field, and click the "Save" button when finished.

Note: An integration's display name can be up to 100 characters. 

Delete Integration

If needed, you can delete a PMS integration by following the steps below.

Important: Deleting a PMS integration is an irreversible action that results in the permanent loss of data. Aruvo strongly recommends not deleting an integration unless you are certain you no longer need it or its associated data.

• Navigate to the Integrations Page in Aruvo
• Locate the integration to be updated, and click the "Delete" button next to the integration name

• The system will pop up a warning message, noting that deleting the integration will stop the sync between Aruvo and Hostaway. Follow the steps to proceed with deletion.
  • Click the check-box to acknowledge "I understand that this action cannot be reversed".
  • Type the word "Delete" into the provided field.
  • Click "Delete Integration" to confirm and delete.

• The system will update with a success message after deletion is completed. Click the "OK" button to acknowledge and close the window.

📎 Related Articles

• How to: Link Aruvo TV to property
• How to: Turn PMS Stay Syncing On and Off
• How To: Create your Aruvo TV account
• FAQ: Aruvo TV