Outlook Calendar Sync

Outlook calendar sync writes academic course sessions into Microsoft Outlook. Each person who has sync turned on gets an Outlook event for every session they take part in, kept up to date as sessions change, and each room with its own Outlook calendar gets a booking for every session held in it. Sync runs one way, from Full Fabric to Outlook: changes made to the events in Outlook are not read back. Full Fabric writes to the calendars through your Microsoft oAuth connection, so nobody has to sign in to Outlook from Full Fabric.

Before You Start

  • Microsoft oAuth is connected and enabled, with Outlook calendar showing Granted on the Permissions card. See Microsoft oAuth.
  • Outlook calendar sync is switched on for your institution. It is part of the Academics capability, off by default, and switched on by Full Fabric.

Turning either one off stops all calendar traffic, for people and rooms alike.

How It Works

  1. Sync is turned on for a person, by the person from the academic calendar or by an administrator for a whole role.
  2. The first sync fills the calendar: Full Fabric creates an event for each session the person can see, from now up to the Sync until date (or ten years ahead when no date is set).
  3. Changes follow automatically: creating, editing or deleting a session updates the events of everyone synced to it, and of its room. Removing a person's course registration removes their events for that course's sessions.
  4. Everything runs in the background: the person keeps working while events are written.

Who Gets Which Sessions

Person (with sync on) Sessions synced
Students Sessions they are invited to
Lecturers Sessions where they are a lecturer or guest lecturer, on the session or on its course
Staff who are not lecturers Every session in the courses their access scope covers, so all sessions when their scope is not limited to programmes

Applicants never receive events. Each event goes to the person's main email address, or to the address matching Domain match when one is set on the Microsoft oAuth page.

What an event contains

Outlook field Content
Title The subject name (with its code when your institution shows subject codes in calendar entries), the course name and the session title
Body The session title, its lecturers and its guest lecturers
Location The room name, or the session's location when it has no room
Time The session's start and end, in the session's time zone

A recurring session becomes one recurring Outlook series. Occurrences deleted from the series are left out of it, and occurrences edited on their own get an event of their own. The series ends at the session's own end, or at the Sync until date if that comes first.

Institution Settings

The Outlook sync card sits on the Microsoft oAuth page (Settings → Microsoft integrations → Authentication → oAuth).

Setting Notes
Sync until Outlook sync includes sessions up to and including this date. Pick a date from today up to ten years ahead, or clear it for no limit. Changing it re-syncs every synced person's calendar and every room calendar.
Turn on sync for Everyone (students, lecturers and staff), Students, Lecturers or Staff, then click Turn on sync.

Turn on sync switches sync on for the people in that role who do not have it yet and queues their first sync; people already syncing are left alone. The page confirms "Outlook sync is on for" the role and that "Their calendars sync in the background." People whose mailbox fails the checks below are skipped.

Turning Sync On for Yourself

Staff who can view the academic calendar open it and click Calendar feed. The Calendar subscription window has two rows:

  • Microsoft Outlook: Connect turns sync on and starts the first sync. The button reads Syncing... until it finishes, then Disconnect. Disconnect turns sync off and removes the upcoming events Full Fabric created.
  • iCal Feed: Copy URL copies a personal calendar feed with every session the person can see, past and future. It works with calendar apps that subscribe to a URL. Anyone with the link can read the feed, so keep it private.

The Microsoft Outlook row only appears when Outlook sync and Microsoft oAuth are both on, and when the person already syncs or their mailbox passes the checks: an address matching Domain match (when set), and a calendar Full Fabric can read in your Microsoft tenant.

Rooms

In Settings → Data management → Rooms, add or edit a room and fill in Outlook Calendar Email with the room's Outlook calendar address. Each room needs its own address. The field only appears while Outlook sync and Microsoft oAuth are on.

For every session in that room, Full Fabric books the room calendar with an event titled with the course name followed by BOOKED, listing the session, course and session ID. Moving a session to another room moves the booking; deleting the session removes it.

When staff pick a room with an Outlook calendar in the session editor, Full Fabric checks the room's availability in Full Fabric and in Outlook and warns "Room is already booked for this time". The warning does not stop the save. Sessions edited as part of an existing recurring series are not checked, and if Outlook cannot be reached the room is treated as available.

Sync Management

Outlook operations are recorded in Sync management (in the top bar's settings menu) under the Outlook app, with types such as Sync Events, Remove Events, Resync Events, Send Session, Update Session, Create Event, Update Event, Delete Event and Sync Reconciliation. Use Filter guide on that page for what each type covers, and see Sync management for how to read and handle entries.

Common Failures

What you see Usual cause Fix
No Microsoft Outlook row under Calendar feed Outlook sync or Microsoft oAuth is off, or the person's mailbox fails the checks Check both are on; check Domain match and that the person has a Microsoft 365 mailbox in your tenant
"Your email is not valid for Outlook sync. Please contact your administrator." The mailbox failed the checks at Connect As above
Turn on sync confirms, but some people get no events They failed the mailbox checks and were skipped Fix their email address or mailbox, then run Turn on sync again
Sync until reports "Until date cannot be in the past" or "Invalid date format" The date was rejected Pick a date from today onwards, or clear it
A person's sync turns itself off Microsoft refused Full Fabric's access during their first sync Check Permissions on the Microsoft oAuth page, then turn sync on again
Disconnect leaves events in Outlook The person's address no longer passes the checks, so sync was switched off without touching Outlook Delete the leftover events in Outlook
Failed Outlook entries in Sync management The entry's message names the cause, for example "Invalid mailbox", "Mailbox not enabled for API access", "Calendar event not found in Outlook" or "Access denied" Fix the mailbox or permission in Microsoft 365. Throttling by Microsoft is retried automatically.

Permissions

Action Who can do it
Configure Microsoft oAuth and the Outlook sync card Staff with Global integrations, see Integrations
Turn on sync, and Calendar feed with Connect in the academic calendar Staff with affairs.academic_services_years_terms_access
Set a room's Outlook Calendar Email Staff with core.institutions.institutions_rooms_change
View Sync management Staff with integrations.sync_management_access