Skip to main content

Connect Microsoft Calendar

This guide walks you through connecting your Microsoft Calendar to CalendarPipe. Microsoft Calendar uses OAuth 2.0 with PKCE via the Microsoft identity platform, supporting both personal Microsoft accounts (Outlook.com, Hotmail) and work/school accounts (Microsoft 365).

Prerequisites​

  • A Microsoft 365 or Outlook.com account with calendar access
  • You must be able to sign in to the Microsoft account in your browser

Connection Steps​

1. Start the connection​

Navigate to Calendar Connections in the CalendarPipe sidebar and click Add Connection.

2. Select Microsoft​

Choose Microsoft from the list of calendar providers.

Screenshot: Microsoft provider selection

3. Sign in and grant access​

You will be redirected to the Microsoft sign-in page (login.microsoftonline.com). Sign in with your Microsoft account.

Microsoft will show a consent screen asking you to grant CalendarPipe the following permissions:

  • Read and write access to your calendars (Calendars.ReadWrite) -- Allows CalendarPipe to read events from source calendars and write synced events to target calendars.
  • Read your profile (User.Read) -- Allows CalendarPipe to identify your account.

Screenshot: Microsoft sign-in page

Screenshot: Microsoft permissions consent dialog

Click Accept to grant access. CalendarPipe uses the multi-tenant endpoint (login.microsoftonline.com/common) which supports both personal and organizational accounts.

4. Select calendars​

After granting access, you will be returned to CalendarPipe where you can select which calendars from this Microsoft account should be available for sync rules.

Screenshot: Calendar selection after Microsoft connection

Work and School Accounts​

Admin Consent May Be Required

If you are using a work or school account (Microsoft 365), your organization's Entra ID (formerly Azure Active Directory) administrator may need to grant consent for CalendarPipe before you can connect. If you see an "Approval required" message during sign-in, contact your IT administrator and ask them to approve the CalendarPipe application.

Troubleshooting​

  • "Approval required" message -- Your organization's Entra admin has restricted third-party app access. Contact your IT administrator to approve CalendarPipe.
  • "AADSTS" error codes -- These are Microsoft identity platform errors. The most common cause is signing in with the wrong account type. Try signing out of all Microsoft accounts first and then reconnecting.
  • Calendars not showing -- Shared mailbox calendars and delegate calendars may not appear. Only calendars owned by or directly accessible to your account will be listed.
  • Connection expired -- CalendarPipe automatically refreshes your Microsoft access token. If a connection stops working, try disconnecting and reconnecting.