CalPair guide · Microsoft 365

Which calendars can sync — with which permissions?

Choose the app's permissions. Then see which calendars it can read, change and synchronize, and how it can detect updates.

CalPair currently requests Calendars.ReadWrite for your own calendars. The selection below starts there.

1Which scopes has the user granted to the app?

All four are delegated permissions: the app acts through a personal user login. “Shared” expands the calendars it may access.

Calendar scopes match CalPair today. The results below also depend on the calendar access you select.

ReadWrite already includes reading. A tick means the permission is actually granted in the access token, not just configured in Microsoft Entra.

Other calendar in the sync pair:

The other calendar has its own connection and permissions. These two checks represent its effective app access.

2Compare the three calendar types

Granted scopes: Calendars.ReadWrite. User grants and the other calendar’s access are applied below.
YOUR OWN MAILBOX

Personal calendar

A calendar belonging to the user who signs into the app.

User access

The signed-in user owns this calendar. No additional calendar-sharing grant is needed.

Read appointments✓ Possible
Create / change / delete✓ Possible
OUT✓ Possible
Own calendarOther calendar

Read this calendar; write copies into the other calendar.

IN✓ Possible
Own calendarOther calendar

Read the other calendar; write copies into this calendar.

BOTH WAYS✓ Possible
Own calendarOther calendar

Read and write on both sides. Changes follow the sync rules.

Polling · regular checks✓ Possible

The app can check periodically. Delay depends on the sync interval.

Push · change notification✓ Possible

Supported for events in the signed-in user’s mailbox. The app must maintain its subscription.

Read: any selected calendar-read permission. Write: Calendars.ReadWrite or ReadWrite.Shared.
ANOTHER PERSON'S MAILBOX

Shared / delegated calendar

A colleague gives the signed-in user access to their calendar. Direct access to the owner.

User's access granted by owner / admin
Read appointments× Blocked
Create / change / delete× Blocked
OUT× Blocked
Colleague calendarOther calendar

Missing app scope to read this calendar.

IN× Blocked
Colleague calendarOther calendar

Missing app scope to edit this calendar.

BOTH WAYS× Blocked
Colleague calendarOther calendar

Missing app scope to read this calendar.

Polling · regular checks× Blocked

Missing app scope to read this calendar.

Push · change notification× Blocked

Not supported with delegated login, even with Shared scopes. Use polling.

Read: Calendars.Read.Shared or ReadWrite.Shared + user read access. Write: ReadWrite.Shared + user edit access.
TEAM MAILBOX

Shared mailbox calendar

A team calendar accessed through your personal work account. No team-mailbox login.

User's access granted by owner / admin
Read appointments× Blocked
Create / change / delete× Blocked
OUT× Blocked
Team calendarOther calendar

Missing app scope to read this calendar.

IN× Blocked
Team calendarOther calendar

Missing app scope to edit this calendar.

BOTH WAYS× Blocked
Team calendarOther calendar

Missing app scope to read this calendar.

Polling · regular checks× Blocked

Missing app scope to read this calendar.

Push · change notification× Blocked

Not supported with delegated login, even with Shared scopes. Use polling.

Read: Calendars.Read.Shared or ReadWrite.Shared + user read access. Write: ReadWrite.Shared + user edit access.
✓ Possible — requirements met× Blocked — missing scope or access? Check — needs explicit validation
Special case: a shared custom calendar visible in the user's own mailbox. Microsoft documents that some shared custom calendars can be accessed with standard Calendars.Read / ReadWrite through the user's mailbox. The shared/delegated panel above models direct access to the owner's mailbox. The local-copy case must be checked separately; it is not a general Shared Mailbox workaround.

This explorer shows Microsoft API capabilities. It does not claim that a specific sync app has implemented every permitted path. Free / busy access is not enough to copy appointment details.

3How the permissions and updates work together

Scope + user access = effective permission

The app needs the correct scope. For another person's or a shared mailbox's calendar, the user also needs a calendar grant. A scope never grants mailbox membership.

Push tells the app “something changed”

The app then processes the change. For shared/delegated calendars, this personal-login model cannot use push. App-only access is a different admin-approved model.

Polling checks for changes regularly

Possible whenever the app can read the calendar. Updates can arrive with a delay. Reliable deletion, recurrence and conflict handling depend on the sync app.

IT details: app-only access, private events and sources
  • Other CalPair sign-in scopes: User.Read identifies the signed-in user; offline_access lets the connection remain usable between sign-ins. Neither adds calendar access.
  • Own-calendar push: Microsoft's subscription documentation lists Calendars.Read as the least privileged permission. Calendars.ReadWrite also provides read access. A shared-only token still reads own calendars, but subscription acceptance should be validated; this explorer marks that combination “Check”.
  • Shared/delegated push: requires the corresponding application permission, such as Calendars.Read, with admin consent and an appropriate mailbox access scope. Delegated Shared permissions do not support subscriptions to these folders. This is not enabled by checking more delegated scopes above.
  • Shared mailbox access: Full Access normally includes its calendar. A calendar-specific grant may provide only reading or editing. No direct shared mailbox login is needed.
  • Private appointments: details can be hidden depending on the user's calendar grant. Send As / Send on Behalf, meeting invitations and meeting ownership are separate from copying calendar appointments.
  • Polling is not the same as Delta: reading allows regular checks. Availability of an incremental Delta path and safe deletion detection must be validated for the exact calendar access path.
  • Bidirectional: both calendars must allow reading and writing through their respective connections. Updates and deletions only propagate according to the sync app's selected rules.

Microsoft scope referenceShared/delegated API access and local-copy exceptionPush notification permissions and limitsShared mailbox access

This guide explains Microsoft Graph permissions; selecting an option here does not change your account or grant CalPair additional access. Checked on 2 October 2026 — private-event visibility, tenant policies and sync rules can affect the result.