iCal Calendar Sync with StayScan: Complete Guide for Hosts
By StayScan Editorial Team · Published · Last updated
How iCal sync works for Airbnb, VRBO, Booking.com and Agoda, how often it updates, and how to set it up so you never get double booked.
Managing bookings across multiple platforms is one of the biggest challenges for vacation rental hosts. When a guest books on Airbnb, those dates need to be blocked on Booking.com, VRBO, Agoda, and every other platform where your property is listed. Miss one update, and you face a double booking that damages your reputation, costs money, and creates stress.
iCal (iCalendar) is the universal standard that solves this problem. Every major booking platform supports it, and StayScan Calendar Sync makes the entire process simple, automatic, and reliable. This guide covers everything you need to know.
What is iCal and How Does It Work?
iCal (technically iCalendar, defined by RFC 5545) is a standardised calendar format that allows different calendar applications to exchange scheduling information. In the vacation rental world, it works through two mechanisms:
Export (Outbound Feed)
Each platform generates a unique URL that represents your property''s calendar. This URL serves an .ics file containing all your bookings and blocked dates. When another platform imports this URL, it reads those dates and marks them as unavailable.
Import (Inbound Feed)
Platforms periodically fetch (poll) the imported URL to check for changes. When new bookings appear in the feed, the importing platform blocks those dates automatically.
Key Technical Details
- Format: Plain text with structured event data (start date, end date, summary, status)
- Protocol: Served over HTTPS — the URL is all you need
- Refresh: Each platform decides how often to re-fetch the feed (every 15 minutes to 24 hours)
- One-way: Each feed is read-only. Two-way sync requires both import and export on each platform
Why StayScan for Calendar Sync?
While platforms offer native iCal connections directly between each other, StayScan provides a centralised hub that adds significant advantages:
- 5-minute automatic sync: StayScan polls all your connected sources every 5 minutes, far more frequently than platform-to-platform connections
- Conflict detection: Instantly identifies overlapping bookings across platforms before they become problems
- Unified calendar view: See all bookings from all platforms in one dashboard, colour-coded by source
- Manual blocks and direct bookings: Add blocks for maintenance, personal use, or direct bookings that automatically sync to all connected platforms
- Sync health monitoring: Real-time status indicators show whether each connection is working correctly
- Export feed: Generate a single StayScan export URL that all platforms can import, simplifying your connection topology
How to Set Up Calendar Sync in StayScan
Step 1: Access Calendar Sync
From your StayScan dashboard, click the Calendar Sync button in the top right corner. Select the property you want to configure.
Step 2: Import Platform Calendars
For each platform where your property is listed:
- Log in to the platform (Airbnb, Booking.com, VRBO, etc.)
- Navigate to Calendar Settings and find the "Export Calendar" or "iCal URL" option
- Copy the iCal export URL
- In StayScan, click Add Source
- Select the platform name and paste the URL
- Click Connect
StayScan will immediately fetch the calendar and display your bookings. The sync health indicator will turn green once the first successful sync completes.
Step 3: Export StayScan Calendar to Platforms
To push your StayScan blocks and direct bookings back to other platforms:
- In the Sources tab, click Export Calendar
- Click Generate Export URL (first time only)
- Copy your unique StayScan export URL
- Go to each connected platform and import this URL as an external calendar
Once configured, any manual blocks or direct bookings you add in StayScan will automatically appear on all connected platforms.
Supported Platforms
| Platform | Import to StayScan | Export from StayScan | Typical Refresh Rate |
|---|---|---|---|
| Airbnb | Yes | Yes | 3-4 hours |
| Booking.com | Yes | Yes | 4-6 hours |
| VRBO / Expedia | Yes | Yes | 6-12 hours |
| Agoda | Yes | Yes | 6-12 hours |
| Google Calendar | Yes | Yes | 12-24 hours |
| Apple iCal | Yes | Yes | 15 min - 1 hour |
| MakeMyTrip | Yes | Yes | 6-12 hours |
| Expedia | Yes | Yes | 6-12 hours |
| Any iCal-compatible platform | Yes | Yes | Varies |
Important: The refresh rates above are how often the external platform polls the StayScan feed. StayScan itself syncs every 5 minutes — the delay is on the receiving platform''s side.
Sync Timing: What to Expect
Understanding sync timing is critical for managing guest expectations and avoiding conflicts:
StayScan Inbound (importing from platforms)
- StayScan fetches your platform calendars every 5 minutes
- New bookings appear in your StayScan dashboard within 5 minutes of being made
- Conflicts are detected and flagged immediately after each sync
Platform Inbound (platforms importing from StayScan)
- Each platform decides its own refresh schedule
- Airbnb: refreshes every 3-4 hours
- Booking.com: refreshes every 4-6 hours
- VRBO/Expedia: refreshes every 6-12 hours
- Google Calendar: refreshes every 12-24 hours
Practical Implications
If you block dates in StayScan at 2:00 PM, those dates will be blocked on Airbnb by approximately 5:00-6:00 PM and on Booking.com by approximately 6:00-8:00 PM. During this window, a booking could theoretically still come through on the unblocked platform.
Best practice: For time-sensitive blocks, manually block dates on each platform directly in addition to using StayScan. For routine management, the automatic sync is sufficient.
Import and Export: How They Work Together
Import Flow (Platform to StayScan)
When you import a platform calendar into StayScan:
- StayScan reads all events (bookings, blocks) from the platform''s iCal feed
- Events are stored locally and displayed in your unified calendar
- Each event shows its source platform with colour coding
- Cancelled bookings are detected and removed automatically
- StayScan never modifies the source feed — it is read-only
Export Flow (StayScan to Platforms)
When platforms import your StayScan export URL:
- Only manual blocks and direct bookings are included in the export
- Imported events are never re-exported (prevents circular duplicates)
- Cancelled events are included with STATUS:CANCELLED for 14 days so platforms unblock those dates
- The feed is RFC 5545 compliant with proper SEQUENCE numbering for updates
Troubleshooting Common Issues
Sync health shows red
A red indicator means StayScan could not reach the platform''s iCal URL. Common causes:
- The platform changed or invalidated the iCal URL (regenerate it on the platform)
- The platform is temporarily down
- The URL was pasted incorrectly (check for extra spaces or missing characters)
Bookings not appearing after sync
- Verify the source shows a green health indicator
- Check that the booking dates are in the future (past events are not imported)
- Click "Sync Now" to force an immediate refresh
Dates not blocking on other platforms
- Confirm you have imported the StayScan export URL on the target platform
- Remember that platform refresh rates vary (up to 24 hours for Google Calendar)
- Verify the export URL is accessible by opening it directly in a browser
Duplicate bookings appearing
- This usually means the same platform URL was imported twice — remove the duplicate source
- StayScan automatically prevents circular duplicates (events with @stayscan.app UIDs are skipped)
Best Practices for Avoiding Double Bookings
- Connect all platforms immediately: Set up sync for every platform where your property is listed on day one
- Use StayScan as the central hub: Import all platform calendars into StayScan, then export StayScan back to all platforms
- Check sync health daily: A quick glance at the health indicators catches connection issues before they cause problems
- Block dates in StayScan: For maintenance, personal use, or direct bookings, always add blocks in StayScan so they propagate everywhere
- Monitor conflict alerts: StayScan flags overlapping bookings immediately — resolve them before both guests arrive
- Set up instant bookings carefully: If you use instant booking on multiple platforms, the sync delay window is your biggest risk. Consider requiring approval on at least one platform
Frequently Asked Questions
Which StayScan plans include Calendar Sync?
Calendar Sync is available on Starter plans and above. You can connect up to 3 calendar sources on the Starter plan, 5 on Growth, 10 on Pro, and 20 on Business.
How often does StayScan sync my calendars?
StayScan automatically syncs every 5 minutes. You can also trigger a manual sync at any time by clicking "Sync Now" on any source.
Will StayScan create duplicate bookings?
No. StayScan uses unique identifiers (UIDs) to track events. Events exported from StayScan are tagged with @stayscan.app UIDs, and the parser automatically skips these when re-importing to prevent circular duplicates.
What happens if a platform changes its iCal URL?
The sync health indicator will turn red. Simply go to the platform, get the new URL, and update it in StayScan.
Can I sync multiple properties?
Yes. Each property has its own Calendar Sync configuration with independent sources and export URLs.
Does StayScan modify my bookings on other platforms?
No. iCal sync is read-only. StayScan reads your platform calendars and provides its own export feed, but it never writes directly to Airbnb, Booking.com, or any other platform.
What if I get a booking during the sync delay?
StayScan detects conflicts within 5 minutes of a booking being made. If a conflict is detected, you will see it flagged in your dashboard immediately, giving you time to contact the guest and resolve the situation before check-in.
Can I export StayScan to Google Calendar for personal viewing?
Yes. The StayScan export URL works with any iCal-compatible calendar application, including Google Calendar, Apple Calendar, and Outlook.
Ready to eliminate double bookings? Set up Calendar Sync in your StayScan dashboard, or start your 30-day free trial to get started (no credit card needed; plans start at $6/month).
Related articles:
- Calendar Sync for Airbnb Hosts: Prevent Double Bookings
- How to Sync Your Airbnb Calendar with StayScan
- How to Sync Your Booking.com Calendar with StayScan
- Best Tools for Airbnb Hosts
StayScan is a digital guidebook for Airbnb, VRBO, Booking.com and Agoda hosts: one QR code gives guests Wi-Fi, check-in steps, house rules and local tips in 30+ languages. Create your guidebook with a 30-day free trial, no credit card required.