Skip to main content

Connect Microsoft Calendar

Microsoft Calendar connects via OAuth 2.0 with PKCE through the Microsoft identity platform. Both personal accounts (Outlook.com, Hotmail) and work/school accounts (Microsoft 365) are supported.

You will need a Microsoft account with Calendar access and the ability to sign in to it in your browser.

Connect​

1. Start the connection​

Navigate to Calendar Connections in the CalendarPipe sidebar and start a new connection.

2. Select Microsoft​

Choose Microsoft Outlook from the list of providers.

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.

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

4. Confirm the connection​

You are returned to Calendar Connections with the account listed. Every calendar on it is available to pipes straight away — expand the account to see them.

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.

Out of office events​

Outlook has no dedicated out-of-office event type. When a rule's transform sets type: "outOfOffice", CalendarPipe writes the event with the Out of office free/busy status (oof), which is the closest equivalent Outlook supports.

Unlike Google, this works on any Outlook calendar and does not require a Workspace (business) account or a primary calendar.

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.
  • "Reconnect required" on a connected account -- Microsoft stopped accepting the connection, so its pipes are paused. Click Reconnect on the account; you do not need to disconnect first, and the pipes resume on their own. See Reconnecting a connection.
Last updated on