iCal - API
WebHotelier availability calendar syncing via iCal
iCal is a simple calendar file format that is used by some travel websites when API connectivity is not possible.
The format has some severe limitations:
- It does not contain pricing information.
- It contains data only for SOLD OUT days. All other days are considered AVAILABLE.
- It is not possible to enforce rules like min/max stay, no check-in/out, etc.
- It is pull-only. That means that the website that uses it is responsible for calling our endpoint and syncing the information on a periodic basis. Most websites also pull one more time just before booking — to avoid the risk of overbooking — however, there are no transactional guarantees.
- Dynamic pricing rules are not taken into account.
For the above reasons, the iCal format is primarily suitable for Villas, Apartments, etc. However, technically it can also be used for individual hotel room types.
WebHotelier recommends:
For the best results, you should only use iCal on vacation rental listing sites when no other integration options are available.
Table of Contents
URL Endpoint
# Per room type (DEFAULT)
/ical/{propertycode}-{roomcode}.ics
# Entire property
/ical/{propertycode}.ics
# Specific room types
/ical/{propertycode}.ics?types=RM1,RM2,etc
Tip
You can get the full endpoint URL from your room's settings tab on WebHotelier's backoffice.
Supported Websites
Among many others, iCal is supported by the following websites:
| AirBnB |
|---|
| HomeAway/VRBO |
| FlipKey |
| VRBO |
| 9flats.com |
| holidaylettings |
| HouseTrip |
| WIMDU |
| Loving Apartments |
| only-apartments |
| Toprural |
| Homelidays |
| Owners Direct |
| Way to Stay |
AirBnB configuration instructions
Step 1
Step 2
Step 3
Step 4
Step 5
Step 6
