Calendar-link guide

Connect reservation dates—without sharing your password.

HostBlocks is designed to use read-only iCal export links. This guide explains what those links are, where to look for them, and how to keep them private.

HostBlocks is prelaunchNo password requirediCal / ICS

What is an iCal link?

An iCal or ICS link is a read-only calendar address provided by many booking platforms. It usually begins with https:// and may end in .ics. HostBlocks can use a supported link to read reservation dates and organize check-ins, checkouts, and vacancy windows.

It is not the public web address for your listing, and it is not your account password.

Treat an iCal link as private. Anyone who has it may be able to view the limited reservation information published in that feed.

Where to find the export link

  1. Sign in directly to the booking platform or channel manager you already use.
  2. Open the specific property's calendar or availability settings.
  3. Look for wording such as Connect calendars, Sync calendars, Export calendar, iCal, or Calendar URL.
  4. Choose the option to export or copy that property's calendar.
  5. Copy the full URL. Do not copy the browser address for the listing page.

Platforms change menus from time to time. If you cannot find the export option, use that platform's official help center and search for “export calendar” or “iCal.”

How the planned HostBlocks setup works

After signing in and starting or restoring a subscription:

  1. Create or select the matching property in HostBlocks.
  2. Add a useful property name, address, and time zone.
  3. Choose the option to connect a reservation calendar.
  4. Paste the full iCal export URL and add a source label such as “Airbnb” or “Direct calendar.”
  5. Save, then review the initial sync status and imported dates.
  6. Compare a few reservations with the source platform before relying on the schedule.

This flow is still in prelaunch testing. Final button labels may differ, and HostBlocks will not claim a calendar is connected until the feed has been validated and synced.

One property, multiple sources

A property may receive reservations from more than one source. If HostBlocks supports multiple links for that property at launch, label each feed clearly. Imported calendars can contain overlapping or duplicate blocks, so always compare unusual dates with the original booking source.

Do not use one property's link for another property. Each export URL should stay attached to the listing that created it.

Refresh timing and accuracy

iCal is not guaranteed to update instantly. The booking platform decides when it publishes changes, and HostBlocks then needs to retrieve and process the feed. A new, canceled, or changed reservation can therefore take time to appear.

HostBlocks should show sync status and the last successful update when production syncing is enabled. For urgent guest or staffing decisions, verify the reservation in the original booking platform.

Troubleshooting

The link is rejected

  • Confirm you copied an export or iCal link—not the public listing page.
  • Copy the entire URL without spaces or missing characters.
  • Confirm the feed uses HTTPS and comes from a supported provider.
  • Try opening the booking platform's export screen again and generating a fresh link.

A reservation is missing or late

  • Check the original platform first and confirm the reservation appears there.
  • Review HostBlocks sync status and last successful update.
  • Confirm the calendar is connected to the correct property and time zone.
  • Allow for the booking platform's publishing delay, then refresh again.

Dates appear shifted

  • Confirm the property's time zone.
  • Compare both check-in and checkout dates with the source reservation.
  • Report the source, property nickname, affected dates, and a screenshot to support—without sending the private calendar URL.

Protect and replace a calendar link

  • Do not place the link in a public document, chat room, screenshot, or support email.
  • Only connect feeds you are authorized to use.
  • Remove the link when you stop managing a property.
  • If a link is exposed, regenerate or replace it in the booking platform if possible, then update HostBlocks.

Need help? Email support@kingdomturnover.com with the property nickname, source platform, device, and error message. Do not include the actual link.