Hostaway is a property management system, so one connection brings in every listing and reservation it manages — Airbnb, Booking.com, Vrbo and direct bookings — and keeps them in sync with Levio's tax engine.
Four steps
FromAPIkeytofirstsync.
01
Create API credentials in Hostaway
Sign in to your Hostaway dashboard as an account owner or admin.
Open Settings → Hostaway API (under Marketplace / API keys).
Click Create to generate a new API key. Hostaway shows an Account ID (client ID) and an API Key (client secret).
Copy both values now — the API key is only shown once.
02
Add the connection in Levio
Go to Settings → Connect a channel.
Choose Hostaway as the channel and give the connection a label, for example 'Hostaway — Valletta portfolio'.
Optionally add your Hostaway account reference if you manage several accounts.
Paste the Account ID and API key into the API credentials box.
Click Connect channel.
03
How your key is stored
The API key is encrypted with AES-256-GCM before it is written to the database, under a key that lives only in the server environment.
It is write-only: Levio never sends it back to the browser. Settings shows the last four characters so you can tell which key is in place, and you can replace or remove it at any time.
Self-hosting a single-tenant install? You can skip the box and set the HOSTAWAY_ACCOUNT_ID and HOSTAWAY_API_KEY server secrets instead — connections without their own key fall back to those.
04
Run the first sync
Press Sync now on the new connection. Levio pulls your listings and the reservations changed in the last 400 days.
Each reservation is run through the tax engine straight away: the matching rule, taxable nights and taxable guests are recorded.
Stays where Hostaway's connected OTA already collected the tourist tax are marked ota_collected; everything else becomes an outstanding guest payment request.
Re-sync any time — modifications and cancellations update the existing records instead of duplicating them.
Troubleshooting
Whenthesyncdoesn'tland
“No credentials for this hostaway connection”
Nothing is stored on the connection and the server-wide secrets are unset. Open Settings → Connected channels and add the Account ID and API key.
“Hostaway authentication failed [401]”
The API key was revoked or copied incompletely. Generate a new key in Hostaway, then use Replace key on the connection in Settings.
Listings sync but reservations don’t
Levio only imports reservations with activity in the last 400 days, and skips reservations whose listing is not part of the same Hostaway account.