Outlook Calendar Leave Sync: Leave Visibility for Microsoft 365 Teams

For organisations running Microsoft 365, Outlook Calendar is the scheduling backbone. Meetings, resources, and team availability all live in Outlook. When approved leave does not appear on the Outlook calendar, managers schedule meetings with absent employees, and the team loses visibility into who is available.

Leave Balance connects to Outlook Calendar through the Microsoft Graph API, pushing approved leave as calendar events so the entire Microsoft 365 ecosystem sees who is out. Teams, Outlook, and the scheduling assistant all reflect current leave data without manual calendar updates.

Key Takeaways

• Approved leave from Leave Balance creates events on Outlook Calendar automatically
• The Outlook scheduling assistant shows absent employees as unavailable
• The integration works with Microsoft 365 personal, business, and enterprise accounts

Why Outlook Calendar Leave Sync Matters for Leave Management

Microsoft 365 is the dominant productivity suite for mid-size and enterprise organisations. When leave data lives outside Outlook, the scheduling assistant — the tool managers use to find meeting times — shows all employees as available, even when they are on leave.

This creates a predictable frustration: someone books a meeting, sends invitations, and only then discovers the key attendee is on leave. The meeting must be rescheduled, or worse, the absent employee receives notifications they cannot act on.

Outlook Calendar leave sync solves this by ensuring that approved leave appears as a calendar event with the correct dates and times. The scheduling assistant automatically excludes unavailable employees. Managers see at a glance who is free and who is not.

For organisations using Microsoft Teams, the benefit extends further. Teams shows Outlook calendar status, so an employee on leave appears as “Out of Office” in the Teams sidebar. Colleagues see this status before sending a message, reducing interruptions during leave.

How to Set Up Outlook Calendar Leave Sync

Step 1: Authorise Microsoft 365 Access

From your Leave Balance account, navigate to Settings > Integrations > Outlook Calendar and click “Connect Outlook Calendar.”

1. Sign in with your Microsoft 365 account
2. Select the calendar to use for leave events
3. Approve the requested permissions (read and write calendar events)
4. You will be redirected back to Leave Balance

The integration uses OAuth 2.0 via Microsoft Graph API. Leave Balance never stores your Microsoft credentials.

Step 2: Choose Calendar Scope

Option	Use Case
Shared team calendar	All approved leave appears on a shared calendar visible to the team
Individual mailboxes	Each employee’s leave appears on their own Outlook calendar
Both	Shared calendar for team visibility plus individual calendars

The shared calendar approach is recommended for most teams, as it provides a single source of truth for absence planning.

Step 3: Configure Event Settings

Set how leave events appear in Outlook:

• Event title: “Annual Leave — James Park” or “OOO — James Park”
• Show as: “Out of Office” (blocks scheduling) or “Busy” (shows unavailable but allows override)
• Description: Optionally include the leave type or a generic message
• Reminder: Disable reminders for leave events to avoid unnecessary notifications

Setting “Show as” to “Out of Office” is recommended. This prevents the scheduling assistant from treating the employee as available during leave.

Step 4: Map Employees

The integration matches Leave Balance employees to Microsoft 365 users by email address. Verify that each employee’s email in Leave Balance matches their Microsoft 365 UPN (User Principal Name).

For organisations using Azure AD, this is typically the primary email address. For organisations with multiple domains, ensure the correct domain email is used in Leave Balance.

Step 5: Test the Flow

Create a test leave request, approve it, and verify:

1. An event appears on the configured Outlook calendar
2. The event shows the correct dates and “Out of Office” status
3. The Outlook scheduling assistant marks the employee as unavailable
4. Cancelling the leave removes the event

What Data Syncs Between Leave Balance and Outlook Calendar

Data	Direction	Frequency
Approved leave events	Leave Balance → Outlook	Real-time on approval
Leave cancellations	Leave Balance → Outlook	Real-time on cancellation
Leave date changes	Leave Balance → Outlook	Real-time on update
Employee email mapping	Leave Balance → Outlook	On connect, then on change

Best Practices

• Use “Out of Office” for leave events. Setting the event status to “Out of Office” ensures the scheduling assistant and Teams status both reflect the absence correctly.
• Create a dedicated shared calendar. Name it “Team Leave” or “Absence Calendar” so it is easy to find and does not clutter individual calendars.
• Disable event reminders. Leave events should not trigger Outlook reminders. Employees already know they are going on leave.
• Sync public holidays too. Configure Leave Balance to add public holidays to the shared calendar. This gives the Microsoft 365 environment a complete view of non-working days.
• Coordinate with your IT team. If your organisation uses conditional access or application consent policies in Azure AD, the Leave Balance integration may need admin consent before it can connect.

FAQ

Does this work with Outlook on the web and desktop?

Yes. The integration uses Microsoft Graph API, which feeds calendar data to all Outlook clients — web, desktop, mobile, and Teams. Changes appear on all connected clients within seconds.

Can I exclude certain leave types from the calendar?

Yes. In the integration settings, you can choose which leave types create Outlook events. For example, you might exclude sick leave from the shared calendar while keeping annual leave visible.

Does this affect the Microsoft Teams status?

Yes. When an employee’s leave appears on their Outlook calendar with “Out of Office” status, Teams automatically shows them as “Out of Office” to colleagues. This provides visibility without any additional configuration.

Can I use this with shared mailboxes?

The integration supports individual user calendars and shared calendars. Shared mailboxes in Microsoft 365 may require additional Graph API permissions. Check the integration documentation for shared mailbox setup.

What happens if an employee has multiple calendars?

Leave Balance creates events on the calendar you specify during setup. If an employee has multiple calendars, the integration uses the primary calendar by default. You can configure it to target a specific shared calendar instead.