Calendar sync and iCal export
Keep your personal calendar up to date with a live feed of your confirmed bookings.
What the calendar sync does
Sessional exports confirmed bookings as a live iCal feed, the standard calendar format used by Google Calendar, Outlook, Apple Calendar, and most other calendar apps. Once you subscribe, your locum bookings sit alongside your personal appointments.
The feed is read-only. You manage events in Sessional, and your calendar app displays them. When a booking is confirmed, rescheduled, or cancelled in Sessional, the change appears the next time the app refreshes.
Setting up the feed
The URL contains a secure token that identifies your account. Anyone with it can view your booking schedule, so treat it like a password and do not share it publicly.
Adding the feed to your calendar
- Open Google Calendar in your browser.
- Click the + icon next to Other calendars.
- Select From URL, paste the feed URL, and add the calendar.
Google usually refreshes external feeds every 12 to 24 hours.
- Open Outlook and go to Calendar.
- Choose Add calendar, then Subscribe from web.
- Paste your Sessional feed URL and save it.
Outlook refreshes subscribed calendars every 3 to 24 hours, depending on the client.
- On macOS, use File > New Calendar Subscription.
- On iOS, use Settings > Calendar > Accounts.
- Paste the URL and set a refresh interval.
Every hour is a sensible balance between timeliness and efficiency.
How the feed updates
The feed URL itself does not change unless you regenerate it. Your calendar app fetches the latest version each time it refreshes.
What the feed includes
Event title
The organisation name.
Date and time
The start and end time, or all day for daily-rate bookings.
Description
Booking status, rate, and any notes you have added.
Location
The organisation address, if one is recorded.
Only confirmed, delivered, invoiced, and paid bookings are included. Offered and cancelled bookings do not appear in the feed.
Regenerating the feed token
If you believe your feed URL has been compromised or you shared it by mistake, regenerate the token from Dashboard > Calendar. The old URL stops working immediately, and you must add the new URL to each calendar app.
Frequently asked questions
Can I edit bookings from my calendar app?
No. The iCal feed is read-only. To change a booking's date, time, or details, edit it in Sessional. The change will appear in your calendar at the next refresh.
Why is there a delay before new bookings appear?
Calendar apps refresh subscribed feeds on their own schedule. Sessional updates the feed immediately, but your calendar app may not fetch the latest version straight away.
Does the feed include bookings from before I enabled calendar sync?
Yes. The feed includes all confirmed, delivered, invoiced, and paid bookings on your account, regardless of when they were created.
Can I share the feed URL with my agency or organisation manager?
You can, but the feed shows confirmed bookings across every organisation, not just one workplace. If you only want to share your availability, use the availability calendar feature instead.
What happens to the calendar feed if I downgrade from Plus to Basic?
The feed URL stops returning data when your subscription changes to Basic. If you upgrade again, you can regenerate a new feed URL.