Calendox 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. A short note beneath the provider cards summarises what Calendox can access, what it keeps and how it’s protected, and links to How Calendox Protects Your Data.

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

Microsoft first shows its account chooser (Pick an account). Choose the account whose calendars you want to connect — it can be a different account from the one you use to sign in to Calendox, and Use another account adds one that isn't listed. Then 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. After you request approval (or cancel) and return to Calendox, you see "Microsoft did not grant Calendox access to this account." — nothing was connected. Ask your IT administrator to grant admin consent for Calendox in the Microsoft Entra admin center, or contact support@calendox.com for help. Once your administrator has approved Calendox, repeat the Connect Microsoft flow — Microsoft completes without asking for consent again.

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, revoked your sessions, or reset your password — 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 and pick the same account in Microsoft's account chooser; re-authorizing restores access without touching your syncs. Calendox confirms with a short "was already connected" message — nothing is added twice. If this keeps happening after you reconnect, your organization's sign-in policies may be blocking Calendox — ask your administrator.

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

  • "Microsoft did not grant Calendox access to this account." You cancelled Microsoft's consent screen, or your organization requires an administrator to approve Calendox first. Once approval is in place, repeat the Connect Microsoft flow.
  • "Required permissions were not granted." The connection fails unless all requested permissions are accepted. Reconnect and accept the full consent prompt.
  • "Your Microsoft sign-in expired or was already used." You used the Back button or reloaded the page after signing in at Microsoft, or the sign-in took too long, so it can't be completed. Repeat the Connect Microsoft flow from the start.
  • "Microsoft could not complete the sign-in right now." A temporary issue on Microsoft's side — nothing was connected. Wait a few minutes and repeat the Connect Microsoft flow.
  • "Calendox could not start the Microsoft sign-in." The problem is on Calendox's side, not with your account. Try again later, and contact support@calendox.com if it persists.
  • You were asked to sign in to Calendox again. Your Calendox session ended while you were on Microsoft's page. Sign in again and repeat the Connect Microsoft flow.
  • "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.
  • "This address is already connected to Calendox through another calendar provider." The same email address is already connected to your Calendox account as a Google account. An address can be connected once; remove that connection first if you want it here instead.
  • "Calendox could not read an email address for this Microsoft account." The account you picked has no mailbox address Calendox can use to identify it (some organizational accounts are set up that way). Pick an account that has an email address and try again.
  • "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