An API that connects multiple Microsoft services, enabling data access and automation across platforms
Enabling or using Microsoft Graph in a tenant does not “turn on” a separate service that changes tenant behavior globally. Microsoft Graph is the modern API endpoint over Microsoft 365 and Microsoft Entra ID that applications use instead of legacy APIs such as Exchange Web Services (EWS) and Azure AD Graph.
For a scenario like Salesforce moving from EWS to Microsoft Graph, the main impacts are:
- Different API and permission model, not a new workload
- Microsoft Graph is the unified REST API for Microsoft 365 and Microsoft Entra services. It replaces EWS for Exchange Online access and Azure AD Graph for directory access.
- It uses the same Microsoft identity platform (OAuth 2.0) for authentication and authorization as modern EWS apps, but with a more granular permission model.
- There is no separate “Graph switch” that, when enabled, changes how Exchange Online or other services behave for users.
- More granular and secure permissions than EWS
- EWS uses an all‑or‑nothing access model: an app with EWS permissions can typically access everything the user or service account can access in the mailbox.
- Microsoft Graph offers granular scopes such as “read mail only,” “read calendars only,” etc., instead of broad mailbox access.
- For delegated permissions, effective access is the intersection of the signed‑in user’s rights and the app’s consented permissions. For application permissions, effective access is what an admin has consented to for that app.
- This generally improves security posture compared to EWS, but it also means the Salesforce integration must request and be granted the correct Graph permissions to function.
- Change in how “impersonation”/service access works
- EWS impersonation uses a service account that acts as a user.
- With Microsoft Graph there are no service accounts in the same sense; instead, the app authenticates with its own identity using the client credentials flow and is granted application permissions.
- By default, admin consent to those application permissions can allow access to all mailboxes, but an administrator can restrict the app to specific mailboxes using app‑access policies.
- For Salesforce, this means reviewing which mailboxes it should be allowed to access and configuring app‑access policies if needed.
- No automatic breaking changes just from “enabling Graph”
- Existing EWS‑based apps continue to work until EWS is disabled in Exchange Online (currently announced for October 2026).
- Using Microsoft Graph for Salesforce does not in itself break other applications; issues only arise if other apps are modified, removed, or if permissions are changed in a way that affects them.
- The main operational change is that administrators must manage Graph app registrations and permissions (consent, review, and possibly mailbox scoping) for Salesforce instead of or in addition to EWS permissions.
- Why this change is being pushed now
- EWS is deprecated and will be disabled in Exchange Online, and Microsoft is investing in closing parity gaps between EWS and Microsoft Graph for Exchange scenarios.
- Microsoft Graph is the strategic API surface going forward for both Exchange Online and Microsoft Entra ID, with better security, resilience, and feature coverage than legacy APIs.
In practice, adopting Microsoft Graph for Salesforce means:
- Registering or updating an app in Microsoft Entra ID for Salesforce.
- Granting the appropriate Microsoft Graph delegated or application permissions (for mail, calendar, etc.).
- Optionally restricting mailbox access via app‑access policies.
- Leaving other tenant services unchanged unless their configurations are explicitly modified.
There is no tenant‑wide “Graph on/off” switch that would by itself cause unrelated workloads or apps to break.
References:
- Migrate Exchange Web Services (EWS) apps to Microsoft Graph
- Authentication differences between Exchange Web Services (EWS) and Microsoft Graph
- Deprecation of Exchange Web Services in Exchange Online
- Migrate your apps from Azure AD Graph to Microsoft Graph
- Azure AD Graph to Microsoft Graph migration FAQ