Business owner and developer completing a Hostaway Connector WordPress setup guide

Hostaway Connector for WordPress: Complete Setup Guide

To set up Hostaway Connector for WordPress, install the plugin, create Hostaway API credentials, connect your account, add the listing and search pages, then test availability and direct bookings. Use a staging site first, especially if you accept payments.

I build WordPress systems for vacation-rental businesses. In my experience, the setup itself is usually straightforward. The real work is making sure listings, calendars, pricing, and bookings work reliably for real guests.

The HostAway Connector plugin connects WordPress to Hostaway and displays real-time property listings, availability calendars, and direct booking options. It fetches listing, availability, and booking data dynamically rather than storing it locally.

This guide walks through the practical setup, the decisions to make before you start, and the checks I use before launching a Hostaway-connected WordPress site.

What Do You Need Before Setup?

Prepare these items before installing anything.

You will need:

  • A WordPress website with admin access
  • A Hostaway account with API access
  • Your Hostaway Account ID
  • A Hostaway Secret Key
  • A secure place to store credentials
  • A staging or backup copy of your website
  • Your property information and booking rules
  • A payment provider, if you accept deposits or full payment

Hostaway lets you activate its API from Dashboard > Settings > Hostaway API. There, you can create an API key and obtain your Account ID.

Do not start by installing plugins. First define the guest journey. It will save you time later.

Which WordPress Setup Works Best?

Use a clean, fast WordPress setup before adding Hostaway.

I recommend:

  • A lightweight, well-supported theme
  • A staging environment
  • Regular backups
  • An SSL certificate
  • A caching plugin configured carefully
  • A page builder only if you need it
  • Minimal unnecessary plugins
  • A mobile-friendly property layout

Avoid installing multiple booking plugins at once. They can conflict, slow down the site, and create confusing booking rules.

If you use Elementor, test the Hostaway pages on mobile after setup. Property galleries, calendars, and booking buttons need extra attention on small screens.

How Do You Install Hostaway Connector in WordPress?

Install the plugin from the WordPress plugin directory.

  1. Log in to your WordPress dashboard.
  2. Go to Plugins > Add New Plugin.
  3. Search for HostAway Connector.
  4. Click Install Now.
  5. Click Activate.
  6. Open the plugin settings.
  7. Connect your Hostaway account.

The plugin is listed on WordPress.org and connects a WordPress website to a Hostaway account. After activation, check that the plugin settings page appears and that your WordPress version meets the plugin requirements.

Before activating on a live site

Create a full backup first.

A booking plugin can affect pages, templates, URLs, and database settings. A backup gives you a safe way to reverse a problem.

How Do You Connect Hostaway to WordPress?

Connect the plugin using your Hostaway API credentials.

Hostaway uses OAuth 2.0 client credentials. Your Account ID and Secret Key generate a Bearer access token, which can remain valid for up to 24 months.

Follow these steps:

  1. Log in to Hostaway.
  2. Go to Settings > Hostaway API.
  3. Create an API key.
  4. Copy your Account ID.
  5. Copy your Secret Key.
  6. Return to the Hostaway Connector settings in WordPress.
  7. Enter the Account ID and Secret Key.
  8. Generate or retrieve the access token.
  9. Save the settings.
  10. Test the connection.

Hostaway says the Account ID and Secret Key are used to generate the access token, rather than being used directly in every API request.

Security rule I follow

Never place a Hostaway Secret Key in a page template, JavaScript file, or public form field.

Keep credentials in the plugin’s secure settings area or your server environment. If you build a custom integration later, make API requests from server-side PHP.

How Do You Display Hostaway Listings?

Create the pages that will show your properties.

The Hostaway Connector creates or supports pages for property listings and search. A listing page should show the information a guest needs before booking.

Include:

  • Property title
  • High-quality images
  • Location
  • Bedrooms and bathrooms
  • Guest capacity
  • Key amenities
  • Short description
  • Availability calendar
  • Nightly price
  • Minimum-stay information
  • Booking button

Do not overload the page with every possible detail. Guests need clarity, not a wall of text.

A simple property-page layout

SectionWhat it should show
Hero areaProperty image, title, location, rating
Key detailsGuests, bedrooms, bathrooms, property type
DescriptionWhat makes the stay useful
AmenitiesWi-Fi, parking, kitchen, pets, workspace
AvailabilityCalendar and selectable dates
PricingNightly rate, cleaning fee, total estimate
BookingClear call to action
FAQsCheck-in, cancellation, parking, pets

This layout helps visitors make a decision quickly.

How Do You Add a Hostaway Availability Calendar?

Add the availability calendar to each property page.

The calendar should show available and unavailable dates. It should also prevent guests from selecting dates that violate your minimum-stay rules.

The HostAway Connector displays real-time availability calendars and supports direct booking through Hostaway’s API.

Before publishing, test these cases:

  • A fully booked date range
  • A partially available date range
  • A minimum-stay restriction
  • A check-in date that is unavailable
  • A check-out date that is unavailable
  • A date range that crosses a blocked period
  • A booking on mobile

A calendar that looks correct on desktop can still fail on mobile. Test both.

Can Guests Book Directly Through WordPress?

Yes. The Hostaway Connector supports direct bookings through Hostaway’s API.

However, decide your booking model before launch.

You can choose:

  • Request-to-book
  • Instant booking
  • Deposit required
  • Full payment upfront
  • Payment on arrival
  • Manual approval before confirmation

Do not assume that a submitted form equals a confirmed booking. Treat form submission, availability validation, payment, and reservation creation as separate steps.

My recommended flow

For most rental businesses, I recommend this sequence:

  1. Guest selects dates.
  2. WordPress checks availability.
  3. Guest sees the price and terms.
  4. Guest submits the booking.
  5. WordPress rechecks availability.
  6. Hostaway creates the reservation.
  7. Guest receives confirmation.
  8. Your team receives a notification.

This sequence reduces failed bookings and protects your calendar.

How Do You Test the Hostaway Connection?

Test with real scenarios, not only a demo listing.

Check these areas:

  • Property listings load correctly
  • Images display properly
  • Availability dates match Hostaway
  • Pricing displays correctly
  • Minimum-stay rules work
  • Booking form submits
  • Confirmation messages appear
  • Failed bookings show a useful error
  • Mobile layout works
  • Page speed remains acceptable
  • Search Console can index property pages

The Hostaway Connector fetches listing, availability, and booking data dynamically. That means an API issue can affect what guests see. Test after connecting and again after publishing.

What Settings Should You Check After Setup?

Review these settings before launch.

Booking rules

Confirm:

  • Minimum nights
  • Maximum nights
  • Check-in days
  • Check-out days
  • Cancellation policy
  • Cleaning fee
  • Extra-guest fee
  • Security deposit
  • Payment timing

Property content

Check:

  • Titles
  • Descriptions
  • Photos
  • Amenities
  • Addresses or approximate locations
  • House rules
  • Bed configurations
  • Accessibility details

SEO settings

Check:

  • Unique page titles
  • Unique meta descriptions
  • Clean property URLs
  • Image alt text
  • Internal links
  • XML sitemap inclusion
  • Mobile usability

A Hostaway integration can create many property pages. Make sure each page offers useful, specific content rather than near-duplicate text.

What Mistakes Should You Avoid?

Avoid these common setup mistakes.

Installing on a live site first

Use staging or a backup. A booking plugin can affect critical pages.

Exposing Hostaway credentials

Never put API credentials in browser-visible code.

Ignoring mobile testing

Most guests browse rental properties on a phone.

Assuming the calendar is always accurate

Always validate availability before creating a reservation.

Forgetting error messages

A guest should know what to do if a date becomes unavailable or payment fails.

Publishing thin property pages

Do not create dozens of near-identical pages with only the city name changed.

[INSERT: a real client detail, number, or story here — for example, a Hostaway Connector setup issue you diagnosed, such as a calendar, booking, or API configuration problem, and the fix, without inventing private client data.]

How Much Does Hostaway Connector Setup Cost?

A basic Hostaway Connector setup may cost a few hundred dollars. A customised setup with design, SEO, payments, and booking workflows can cost more.

The final price depends on:

  • Number of properties
  • Custom design needs
  • Payment provider
  • Booking rules
  • SEO requirements
  • Multi-language support
  • Guest portal features
  • Testing and support needs

Before requesting quotes, use the Website Cost Calculator to estimate whether you need a basic plugin setup or a full direct-booking system.

When Should You Hire a WordPress Developer?

Hire a developer when the setup affects bookings, payments, guest data, or revenue.

I recommend professional help for:

  • Multiple properties or locations
  • Direct bookings with payments
  • Custom pricing rules
  • Guest portals
  • CRM integrations
  • Multi-language websites
  • Custom search filters
  • Booking approval workflows
  • Calendar synchronisation issues

A developer should test every booking path. They should check available dates, failed payments, duplicate submissions, mobile layouts, and Hostaway API errors.

If you want to compare plugin options first, read my guide on the Hostaway WordPress plugin. It compares HostAway Connector, Bizdesire, and custom development.

For a broader explanation of the integration process, read my guide on how to integrate Hostaway with WordPress.

FAQ: Hostaway Connector WordPress Setup

What is Hostaway Connector for WordPress?

Hostaway Connector is a WordPress plugin that connects a WordPress website to a Hostaway account. It displays real-time property listings, availability calendars, and direct booking options through Hostaway’s API.

How do I connect Hostaway to WordPress?

Create a Hostaway API key, copy your Account ID and Secret Key, then enter them in the Hostaway Connector settings. Hostaway uses those credentials to generate an OAuth 2.0 Bearer access token.

Can guests book directly through WordPress?

Yes. The Hostaway Connector supports direct bookings through Hostaway’s API. You can choose instant booking, request-to-book, deposits, or another booking model depending on your setup.

Does Hostaway Connector store property data in WordPress?

No. The Hostaway Connector fetches listing, availability, and booking data dynamically from Hostaway rather than storing it locally.

Do I need a staging site for Hostaway Connector setup?

Yes, especially if you accept payments or already have traffic. A staging site lets you test listings, calendars, bookings, and errors without affecting live guests.

How long does a Hostaway access token last?

A Hostaway access token can remain valid for up to 24 months. Hostaway recommends renewing it automatically or manually every 12 months.

Next Step

Before installing the plugin, map your guest journey. Define how visitors search, view properties, select dates, pay, and receive confirmation.

If your needs are simple, Hostaway Connector may be enough. If you need custom pricing, guest portals, or complex booking rules, consider a custom Hostaway integration.

You can review my Hostaway WordPress plugin comparison or my WordPress development service. You can also message me on WhatsApp with your property count and booking rules, and I will help you choose the simplest setup that will work reliably.

Tags: No tags

Add a Comment

Your email address will not be published. Required fields are marked *