Skip to documentation content

Channels & Calendar

Import an iCal source

Attach an OTA iCal feed to a room type with a source label, safe URL and bounded quantity so occupied dates block website sales.

Import creates read-only external inventory blocks. It does not import a guest, payment or OTA reservation record. One room type can have multiple sources, and each source has its own provider label, quantity and schedule.

Add a source

  1. Open Hotel Booking → Rooms, edit the room type and select OTA Sync.
  2. Expand Add an iCal source.
  3. Choose the Channel (Booking.com, Airbnb or Other OTA) and enter a clear Source label.
  4. Paste the OTA’s public HTTPS iCal feed URL. A webcal link is normalized to HTTPS; credentials, fragments, IP literals, custom ports and private network targets are rejected.
  5. Set Rooms blocked per event from 1 up to the room inventory quantity.
  6. Keep Sync interval (minutes) at 30 unless the OTA and operating policy require another value between 5 and 1,440.
  7. Leave Source status as Active, select Add source, then use Sync now for the first controlled fetch.

The URL is encrypted at rest and displayed only in masked form. A valid event becomes an external_block for its date interval, check-in inclusive and check-out exclusive. A normal website search counts that block, so guests cannot reserve the same inventory.

Do not add the same OTA reservation through the API and iCal paths. If an OTA changes its URL, edit the source, paste the replacement and save; existing blocks remain until a successful snapshot reconciles them. See sync health when the first run does not complete.

Was this article helpful?

Your feedback helps us improve the documentation.

Export room availability with iCal Create one secure iCal export URL per room type and connect it to an OTA without… Read article → Monitor iCal schedule, retries and health Read iCal health states, understand the 30-minute scheduler and recover failed or stale feeds without clearing… Read article → Distinguish Website, API and iCal sources Read channel labels in bookings and calendars so website reservations, API reservations and iCal external blocks… Read article →