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
- Sync is turned on for a person, by the person from the academic calendar or by an administrator for a whole role.
- 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).
- 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.
- 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 |