Add a Microsoft Exchange Online Account Using Microsoft Graph API

Updated 

The Add via Graph API toggle is designed to help you accelerate the migration of existing Microsoft Exchange Online accounts from EWS to Microsoft Graph API. It allows you to re-add individual Exchange mailboxes through Graph API without waiting for Graph API enablement at the global or account level.

Note: Graph API enablement through the existing Dynamic Property (DP) process remains the long-term requirement for all organizations. The Add via Graph API toggle does not replace or bypass DP enablement. Instead, it provides a temporary, mailbox-level option that enables immediate migration while Graph API enablement continues in parallel.

How This Affects Your Migration

  • If you have already raised a support ticket for Graph API DP enablement or are currently going through the enablement process, continue with that process as planned.
  • You do not need to wait for Graph API DP enablement to re-add your existing Exchange Online accounts through Microsoft Graph API. Simply enable Add via Graph API during account addition and complete the migration.
  • The DP enablement process and mailbox migration can occur simultaneously. DP enablement does not need to be completed before you re-add Exchange accounts through Graph API.
  • Once Graph API DP enablement is completed, future Exchange Online accounts will be added through Microsoft Graph API by default, according to the existing DP-based behavior.

The Add via Graph API toggle provides a faster path to begin your EWS-to-Graph migration immediately for individual Exchange Online mailboxes. At the same time, Graph API DP enablement should continue as planned to ensure long-term adoption and default Graph API onboarding for all future Exchange accounts.

Before You Begin

Before adding an Exchange Online mailbox through Microsoft Graph API, review the required permissions for your Microsoft tenant:

openidemailoffline_accessprofileMail.ReadMail.Read.SharedMail.ReadBasicMail.ReadWriteMail.ReadWrite.SharedMail.SendMail.Send.Shared

Add an Exchange Online Account Through Graph API

  • Turn on 'Is OAuth' toggle to authenticate the Exchange Online account.

  • Enable the 'Add via Graph API' toggle.

  • Complete the Microsoft authentication process.

  • Save the account.

  • The mailbox is added using Microsoft Graph API.

Graph API Toggle Visibility

The Add via Graph API option is available only for authenticated Exchange Online accounts.

Is Auth

Add via Graph API

On

Visible

Off

Hidden

When you turn off Is OAuth:

  • The Add via Graph API toggle is hidden.
  • The Graph API permission note is hidden.
  • The Exchange account follows the standard non-authenticated account addition flow.

How the Graph API Setting Works

The Add via Graph API toggle provides mailbox-level control for Exchange Online account addition. However, it does not override existing Graph API configuration settings.

The following behavior applies:

Scenario

Result

Partner-level Graph API DP is enabled

Mailbox is added through Microsoft Graph API regardless of toggle selection

Account-level Graph API DP is enabled

Mailbox is added through Microsoft Graph API regardless of toggle selection

No Graph API DPs are enabled and the toggle is enabled

Mailbox is added through Microsoft Graph API

No Graph API DPs are enabled and the toggle is disabled

Standard Exchange account addition flow is used

Important Considerations

  • The Add via Graph API option is available only while adding a new authenticated Exchange Online account.
  • The option is not available when editing an existing Exchange account.
  • Existing Exchange accounts are not affected.
  • Existing partner-level and account-level Graph API configurations continue to work without changes.
  • Disabling the toggle does not bypass partner-level or account-level Graph API settings when those settings are already enabled.

Related Articles