CalendoxCalendox Docs
Getting Started

Connect Microsoft Calendar

How to connect your Microsoft account to Calendox and import Outlook calendars — authorization, admin consent, supported calendars, and errors.

Connecting your Microsoft calendar takes about a minute: authorize your Microsoft account from Dashboard → Accounts, then choose which Outlook calendars to import. Both personal Microsoft accounts (outlook.com, hotmail.com, live.com) and work or school Microsoft 365 accounts work, and imported calendars become available in syncs, the Unified Calendar, and booking pages.

Prerequisites

  • A Calendox account with an active trial or subscription — connecting calendars requires one. See Plans and billing.
  • A Microsoft account with an Outlook or Microsoft 365 calendar.

Steps

1. Open the Accounts page

Sign in to Calendox and go to Dashboard → Accounts.

Accounts page showing provider connect options

2. Click the "Outlook Calendar" card

You're redirected to Microsoft's own sign-in and consent screen — Calendox never sees your Microsoft password.

3. Authorize Calendox

Sign in with your Microsoft account and click Accept to grant the requested calendar access — Calendox needs read and write access to sync events. See OAuth permissions for every scope requested and why.

4. Select calendars to import

Back in Calendox, the import dialog opens automatically with the calendars in your Microsoft account. The dialog header shows how many calendar slots remain on your plan. Select the calendars you want to use and click Import.

The Import Calendars dialog with a selectable calendar and read-only calendars locked

5. Confirm

Your imported calendars appear under the Microsoft account on the Accounts page, ready to use in syncs, the Unified Calendar, and booking pages.

Accounts page with imported calendars

Which calendars can I import?

Calendox lists every calendar in your Microsoft account, but only calendars it can write to reliably are importable. Rows that can't be selected are labeled:

LabelMeaning
Read-onlyYou can't edit this calendar in Outlook (for example a calendar shared with you as view-only). Calendox can't sync events into it, so it can't be imported.
Not supportedA group or shared calendar owned by another mailbox — such as the outlook.com "Your family" calendar. These projections don't support reliable writing or change notifications, so Calendox can't sync them. Connect the owning account instead.
Already importedThis calendar is already imported into Calendox — under another of your connected accounts, or by a different Calendox account. A calendar can be imported only once across all of Calendox; remove it from the other account first.
In active syncShown when managing an account's calendars: this calendar is part of an active sync and can't be deselected. Remove it from the sync first.

Each imported calendar counts as one calendar connection against your plan's limit. Connecting the Microsoft account itself doesn't consume a slot — only the calendars you import do.

What if my organization requires admin approval?

Some Microsoft 365 organizations block third-party apps until an administrator approves them. If that's your tenant, the Microsoft consent screen shows an approval-required message instead of completing. Ask your IT administrator to grant admin consent for Calendox in the Microsoft Entra admin center, or contact support@calendox.com for help.

What if Calendox loses access to my Microsoft account?

Calendox refreshes its Microsoft access automatically in the background, so normally you never need to do anything. If access is revoked — an administrator removed the app, or your password changed — Calendox can no longer read or write those calendars, and syncs using them start failing. To fix it, go to Dashboard → Accounts and repeat the Connect Microsoft flow for the same account; re-authorizing restores access without touching your syncs.

How do I remove a Microsoft account?

Go to Dashboard → Accounts, find the account, and remove it. An account whose calendars are part of an active sync can't be removed directly — delete the sync first, then remove the account. Removing the account deletes Calendox's stored access token; to also revoke Calendox on Microsoft's side, see Revoking access.

Troubleshooting

  • "Required permissions were not granted." The connection fails unless all requested permissions are accepted. Reconnect and accept the full consent prompt.
  • "This account is already connected to Calendox by another user." Each Microsoft account can be connected to only one Calendox account at a time. Use a different account, or disconnect it from the other Calendox account first.
  • "Some selected calendars are already imported by another Calendox account." A calendar can exist in Calendox only once. Deselect the conflicting calendars, or remove them from the account that currently has them.
  • "This account has already been used with a free trial." During the trial, you can't connect a provider account whose email has already consumed a Calendox trial. Subscribe to a plan to connect it.
  • A family or group calendar is marked "Not supported." It's owned by another mailbox, so Calendox can't sync it from your account — connect the account that owns it instead.
  • "0 calendar slots remaining on your plan." You've reached your plan's connection limit. Remove a calendar you no longer need or upgrade — see Plans and billing.

Next steps