Black Friday
Skip to documentation content

Channels & Calendar

Export a room type’s unavailable dates with iCal

Pro provides a protected iCal export per room type. Although OTAs often call this an availability calendar, the feed represents fully unavailable nights; it does not publish prices, guest identities or a numerical count of remaining rooms.

Pro provides a protected iCal export per room type. Although OTAs often call this an availability calendar, the feed represents fully unavailable nights; it does not publish prices, guest identities or a numerical count of remaining rooms.

  1. With compatible Core, entitled Pro and channel-management permission, open the room type’s OTA/iCal tab.
  2. Create its export URL through the supported action and copy it privately into the intended OTA’s calendar-import setting.
  3. Preserve the one-time URL securely. Later administration cannot recover its plaintext and may require rotation.
  4. Verify the destination’s own import result and polling behavior separately from a successful website fetch.

The endpoint returns a calendar rather than JSON. The token and current feature authorization are checked for each request, including conditional requests. An old/unknown token or unavailable entitlement does not authorize feed access.

Understand the inventory representation

Each fetch reads current Core occupancy, including active website reservations and external blocks. Check-out is exclusive. Consecutive fully unavailable nights are coalesced into date events with an opaque UID and generic Unavailable summary, within the bounded export horizon.

Partially occupied room types are not exported as fully unavailable. For example, one occupied unit of a three-unit room type does not tell an OTA that two rooms remain. A room marked unavailable or with zero quantity closes its export horizon. Confirm that these semantics fit the provider’s room mapping before using a pooled-room calendar.

Rotate and recover

Use Regenerate/Rotate when the link may be exposed. The old token stops authorizing future fetches; update every legitimate consumer and check its next refresh. Rotation cannot recall previously downloaded calendar copies or choose an OTA’s polling interval.

Do not forward the full link in screenshots, logs or public support threads. If an expected date is absent, inspect total room quantity, blocking states, source mapping, horizon and whether the type is actually sold out. Never force a feed by exposing booking data or editing ledger/history.

See importing a source and token security.

Was this article helpful?

Your feedback helps us improve the documentation.