How do I setup Microsoft Teams or Graph API access in BusyCal?
BusyCal on the mac allows you to add Microsoft Teams meetings to all your Office 365 events, which requires connecting to Microsoft's Graph interface. The new Office 365 connection type recently added in v2024.2.1 also requires access to Microsoft Graph. Your O365 account admin most likely will need to give BusyCal permissions to connect to your account, which has been explained below.
To learn more, please see this article.
Authentication Explained
When setting up an Office 365 account (over Exchange Web Services) and enabling Microsoft Teams, you may see repeated authentication prompts, which would indicate that your Office 365 Account Admin has blocked access to Microsoft Graph or has yet not configured Microsoft Graph related security scopes for third party apps.
We use Microsoft's provided authentication library and are a Microsoft Verified Publisher under our parent company Beehive Innovations. The verified badge is clearly visible as you attempt to authenticate. All your data is private and secure; this has been clearly expressed under our Privacy Policy: https://busymac.com/privacy.html
If you have Admin access to the Azure Portal of your Office 365 account, you will need to follow these instructions to enable Microsoft Graph for BusyCal. If you do not have Admin access, you would need to request your account administrator to follow these instructions.
To allow BusyCal to function optimally, you will need to grant it permissions to access your account with Offline Connectivity features. This enables BusyCal to manage your calendars with the same capabilities as other clients like Apple Calendar or Outlook. As outlined in our privacy policy, your data remains private and secure—only accessible by you on your device. All data interactions occur over secure HTTPS connections using Microsoft’s publicly available APIs, ensuring your information is protected.
Step 1: Sign in to Azure Portal
- Visit: Azure Portal
- Sign in with your administrator account.
Step 2: Register or Find the Application
- In the search bar at the top, type and select "Azure Active Directory".
- Click on "App registrations" in the left-hand menu.
- If BusyCal is already registered, you'll see it listed here. If not, you might need to register it by clicking on "New registration".
- When registering BusyCal as a new application, you must use its Application (client) ID: 885773d6-1859-4189-9b95-b9128fe95ae1 when prompted, and its Directory (tenant) ID: 0a949a24-a061-45c1-92ef-d67b4f2e4182
Step 3: Granting Permissions
Select BusyCal from the list of applications (or after it has been registered).
Click on "API permissions" in the left-hand menu.
Add Delegated Permissions for the following (need to be added one by one):
- Calendars.ReadWrite (required for accessing event calendars / events)
- Calendars.ReadWrite.Shared (required for accessing shared calendars)
- User.Read (required to read timezone and other settings)
- User.ReadBasic.All (recommended needed for free / busy availability and email lookups when sending invites)
- Tasks.ReadWrite (required for reading / writing to owned task lists)
- Tasks.ReadWrite.Shared (required for accessing shared task lists)
- People.Read (required for looking up attendees)
- MailboxSettings.Read (required for reading mailbox settings / preferences)
Step 4: Grant Admin Consent
- After adding the necessary permissions, click on the "Grant admin consent for [Your Organization]" button at the top of the "API permissions" page.
- Confirm your choice in the prompt that appears.
Step 5: Verify & Complete
- After granting consent, the status of the permissions should change to indicate they are now granted.
Now quit and relaunch BusyCal and try setting up the account again. If you're connecting to the new Microsoft Graph Account, please delete the account and add it back again.
If instead you're trying to access "Microsoft Teams" from a Office 365 account over Exchange Web Services, try enabling the "Microsoft Teams" checkbox from Settings > Accounts under your Office 365 account settings and try again.
5002, -5001, -5002, office 5002, MSAL error, MSAL 5000, one click teams meetings, one-click teams, microsoft teams, team, microsoft, office 365 teams, O365 teams, O365, office teams, teams not working, repeated authentication, multiple auth requests, too many authentication requests, auth prompts, authentication prompt, teams won't work, how to add teams meeting