Get started

Setup guide

Connect Hostfully

Hostfully is a property management system, so one connection brings in every property in the agency and the bookings behind them — whichever channel the guest arrived from — and keeps them in sync with Levio's tax engine.

Five steps

From API key to live updates.

  1. 01

    Create an API key in Hostfully

    • Sign in to the Hostfully agency portal as an owner or administrator.
    • Open Settings → API (Hostfully lists it under the agency-level settings, not per property).
    • Generate a new Public API key. Copy it straight away — Hostfully shows the full key only once.
    • If your plan does not expose the API section, ask Hostfully support to enable Public API access for the agency.
  2. 02

    Find your Agency UID

    • The agency UID is the long dashed identifier (a UUID) that scopes every API call to your agency.
    • It appears in the same Settings → API panel, and in the address bar when you are viewing the agency dashboard.
    • If you manage several agencies, take the UID of the one whose properties you want in this Levio workspace, and add one connection per agency.
  3. 03

    Add the connection in Levio

    • Go to Settings → Connect a channel.
    • Choose Hostfully as the channel and give the connection a label, for example 'Hostfully — Sliema portfolio'.
    • Paste the API key and the Agency UID. Leave the API base URL blank unless Hostfully has given you a different host.
    • Click Connect channel. The key is encrypted with AES-256-GCM before it is stored and is never sent back to the browser.
  4. 04

    Run the first sync

    • Press Sync now on the new connection. Levio pulls your Hostfully properties and the leads checking in from roughly the last 400 days.
    • Hostfully calls a booking a 'lead', so only leads in a booked state (booked, checked in, checked out) are treated as stays. Enquiries and holds are ignored.
    • Each stay is run through the tax engine immediately: the matching rule, taxable nights and taxable guests are recorded.
    • Re-sync any time — modifications and cancellations update the existing records instead of duplicating them.
  5. 05

    Live updates, without pasting a URL

    • Hostfully registers webhooks through its API, and Levio already holds your key — so Levio subscribes on your behalf as soon as the connection is created. There is no callback URL for you to copy.
    • New bookings, changes and cancellations then reach Levio within seconds, and only the affected stay is recalculated.
    • Check the Live updates row on the connection in Settings: it shows the last event received, so a webhook that has quietly stopped is visible rather than silent.
    • The scheduled sync keeps running underneath. Webhooks get dropped, and a missed cancellation is a filing error — the sync is what repairs it.

Troubleshooting

When the sync doesn't land

“Missing its API key or Agency UID”
One of the two fields was left blank and no HOSTFULLY_API_KEY / HOSTFULLY_AGENCY_UID server secret is set. Add both to the connection, then sync again.
Hostfully request failed [401] or [403]
The key was revoked, copied incompletely, or is not enabled for this agency. Generate a new key in Hostfully and update the connection.
“Hostfully cannot reach…” when enabling live updates
Hostfully calls in from its own servers over HTTPS, so a localhost address will never receive anything. Point LEVIO_WEBHOOK_BASE_URL at a public HTTPS origin — a tunnel in development.
Properties sync but bookings don’t
Levio only imports leads with a check-in inside the sync window and in a booked state, and skips leads whose property is not part of the same agency UID.
Go to settingsConnecting Hostaway instead