Skip to main content

How do I setup Microsoft Teams or Graph API access in BusyCal?

BusyCal on Mac allows you to add Microsoft Teams meetings to all your Office 365 events, which requires connecting to Microsoft's Graph interface.

In many cases, your Microsoft Entra (formerly Azure AD) administrator will need to grant permissions before BusyCal can access your calendar. The correct setup is explained below.

Authentication & Repeated Prompts​

When setting up an Office 365 account (Exchange Web Services) with Microsoft Teams, repeated authentication prompts may appear if your IT Administrator has not granted the required permissions in Microsoft Entra.

BusyCal uses Microsoft's official authentication library and is a Microsoft Verified Publisher under the company name Beehive Innovations (BusyMac is our domain name). The verified badge appears during authentication. All data remains private and secure, as outlined in our Privacy Policy.

To avoid authentication issues, your IT administrator needs to grant Admin Consent via Microsoft Entra. Follow the steps below.

If you are an Entra Administrator, follow these steps to approve BusyCal for all users.

  1. Log into Microsoft Entra.
  2. Navigate to Identity > Applications > Consent and Permissions > Admin Consent Settings or go directly to: Admin Consent Settings
  3. Ensure that users can request admin consent for third-party apps like BusyCal.

Step 2: User Requests Admin Approval​

  1. Have the user connect their Microsoft 365 account in BusyCal.
  2. A prompt will appear requesting Admin Consent approval.
  1. In Microsoft Entra, go to: Identity > Enterprise Applications > Admin Consent Requests
  2. Locate the request for BusyCal in the list.
  3. Click on it and approve the requested permissions.

Step 4: Assign Users & Groups​

  1. In Microsoft Entra, go to Enterprise Applications > BusyCal > Overview.
  2. Click "1. Assign users and groups".
  3. Add the user(s) or group(s) who need access to the application.
  4. Save the settings.

Once completed, the user should now be able to connect BusyCal successfully.

Alternative: Enabling Microsoft Graph Access via Azure (Manual Setup)​

If your organization prefers direct Azure configuration, follow these steps:

Step 1: Sign in to Azure Portal​

  • Visit: Azure Portal
  • Sign in with your Administrator account.

Step 2: Register or Find the Application​

  • Search for "Azure Active Directory" in the top bar.
  • Click on "App registrations" in the left-hand menu.
  • If BusyCal is listed, select it. If not, click "New registration" to register it manually.
  • Use these IDs when prompted:
    • Application (Client) ID: 885773d6-1859-4189-9b95-b9128fe95ae1
    • Directory (Tenant) ID: 0a949a24-a061-45c1-92ef-d67b4f2e4182

Step 3: Granting Permissions​

  1. Select BusyCal from the list of applications.

  2. Click on "API permissions" in the left-hand menu.

  3. Add the following Delegated Permissions one by one:

    • Calendars.ReadWrite (Required for calendar events)
    • Calendars.ReadWrite.Shared (Required for shared calendars)
    • User.Read (Required for timezone and settings)
    • User.ReadBasic.All (Recommended for free/busy availability & email lookups)
    • Tasks.ReadWrite (Required for personal task lists)
    • Tasks.ReadWrite.Shared (Required for shared task lists)
    • People.Read (Required for attendee lookups)
    • MailboxSettings.Read (Required for mailbox settings/preferences)
  • Click "Grant admin consent for [Your Organization]" at the top of the API permissions page.
  • Confirm the consent request.

Step 5: Verify & Complete​

  • The status of the permissions should update to granted.
  • Quit and restart BusyCal, then try connecting again.

Troubleshooting & Final Steps​

If BusyCal continues to prompt for authentication:

  • Microsoft Entra: Ensure admin consent has been granted under Enterprise Applications.
  • Azure Portal: Confirm that permissions were assigned correctly and consent was granted.
  • Try Reconnecting: Delete and re-add your account in BusyCal.

For Microsoft Teams Integration (if using Exchange Web Services):

  • Enable the Microsoft Teams checkbox in Settings > Accounts under your Office 365 account settings.

admin office 365, admin o365 permission, ms graph permission, 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, Microsoft Entra permissions, Entra admin consent, Entra enterprise applications, Entra admin consent request, grant admin consent Microsoft, Microsoft consent request, Entra ID, Microsoft Entra ID, Entra portal, enterprise applications permissions, app consent approval, Entra Teams integration, Azure AD consent, Microsoft Graph API permissions, Microsoft Graph admin consent, Graph API O365, Microsoft Graph OAuth, Exchange Web Services authentication, Exchange Web Services Teams, EWS Microsoft Teams, Teams calendar integration, Teams admin approval, O365 calendar access, Exchange calendar API, Office 365 API permissions, Azure app registration, Azure Active Directory permissions, Microsoft account authentication error, OAuth consent approval, BusyCal admin approval, BusyCal Microsoft Graph setup, BusyCal Azure setup, BusyCal authentication failure, Teams OAuth error, Microsoft Graph access denied, BusyCal admin settings, Office 365 calendar permissions, Teams meeting not showing, Teams calendar sync issue, O365 Teams meetings BusyCal, BusyCal Microsoft Teams authentication, Teams permissions for calendar access, Azure Entra app registration, Azure AD API access, grant permissions for Microsoft Graph, organization admin approval Microsoft, BusyCal Microsoft 365 integration

Last updated on