Integrations · Microsoft Teams

Sync your Microsoft Teams calendar

Connect your Microsoft 365 account, then choose whether each Tookan calendar should sync with Microsoft Calendar.

All documentation

Before you start

The calendar shown in Teams is your Microsoft 365 (Outlook) calendar. Use the work or school account that owns it. Your organisation may require administrator consent. Tookan calendars are disabled by default and can be enabled separately.

1. Connect your Microsoft account

  1. Open the integration

    In Tookan, open Settings > Integrations > Microsoft Teams, then click Connect a Microsoft account.

  2. Allow access

    Sign in with the Microsoft 365 account used in Teams. Review the calendar permissions and accept them for your account. Only approve consent for the whole organisation if you are authorised to do so.

  3. Check the account

    The connected email address appears at the top of the page. You can then choose which Tookan calendars to sync.

Open the Microsoft Teams integration

2. Choose none, one or several calendars

Each Tookan calendar has its own Sync direction setting. Unconfigured calendars default to None.

Your choiceWhat to do
No calendarsLeave None on every Tookan calendar and click Save. You do not need to choose a Microsoft calendar; the other settings are hidden.
One calendarChoose a direction on the Tookan calendar you want, select its Microsoft calendar, then save. Leave the others on None.
All or severalChoose a direction and Microsoft calendar on each Tookan calendar you want to sync, then save each card separately. Several Tookan calendars can use the same Microsoft calendar.

3. Set the sync direction

DirectionEffect
NoneNo sync for this Tookan calendar; no Microsoft calendar is required.
Microsoft Calendar → TookanBusy Microsoft events are imported into Tookan. Tookan appointments are not sent to Microsoft.
Tookan → Microsoft CalendarTookan appointments are copied to the selected Microsoft calendar. Microsoft events are not imported.
Tookan ↔ Microsoft CalendarTookan appointments are exported and busy Microsoft events are imported.
  • For a direction that imports Microsoft events, select the Tookan availabilities that should take them into account in suggestions.
  • A read-only Microsoft calendar can be used for Microsoft Calendar → Tookan, but not for a direction that exports Tookan appointments.
  • Imported Microsoft events are read-only in Tookan: edit them in Microsoft Calendar.

4. Save and check

  1. Save each calendar

    Click Save in the relevant Tookan calendar card. For None, Save remains available without selecting a Microsoft calendar.

  2. Run a sync

    Click Sync now at the top of the page. The summary shows calendars processed, appointments imported or exported, failures and deferred operations. Only enabled calendars are processed.

  3. Check an appointment

    Check a busy event in the importing Tookan calendar or a Tookan appointment in the exporting Microsoft calendar, depending on the selected direction.

Why is Microsoft authorisation refused?

Your organisation may restrict consent to applications. Ask its administrator to allow the Tookan Calendar app for your account. If access has expired, click Renew Microsoft authorisation.

Why is a calendar missing or disabled?

Check that the connected Microsoft account can access it. A read-only shared calendar cannot receive Tookan appointments; choose Microsoft Calendar → Tookan or an editable calendar.

What happens if I change direction or calendar?

Tookan removes copies that no longer match the setting and keeps original appointments. Changing a Microsoft calendar affects only the Tookan calendar you save.