Communication

Microsoft Mail OAuth Integration

Connect Microsoft Mail to your application without building and maintaining the OAuth flow.

Microsoft Mail gives access to Outlook mail through Microsoft Graph. Each user connects their own Microsoft Mail account through your OAuth app. Pathfix manages the authorization flow, stores and refreshes their tokens, and authenticates the requests your application makes to the Microsoft Mail API. What your integration does with that access is up to your code.

Start building with Pathfix Read the Pathfix docs

How Pathfix helps

01
OAuth authorization
Pathfix runs the authorization flow with your Microsoft Mail OAuth app, so users approve access on Microsoft’s own consent screen.
02
Token management
Each user’s access and refresh tokens are stored by Pathfix rather than in your application.
03
Token refresh
Where Microsoft Mail issues refresh tokens, Pathfix refreshes them as they expire, so connections keep working after the first authorization.
04
Authenticated API passthrough
Your application sends Microsoft Mail API requests through Pathfix, which adds the connected user’s credentials before passing them on to Microsoft Mail.

You own the Microsoft Mail OAuth application and its credentials, and your code implements the API logic.

Passthrough endpoint for Microsoft MailPOST https://labs.pathfix.com/oauth/method/msgraphmail/call

How to get started

1
Register your app with Microsoft
Create an app in Microsoft’s developer settings to get a Client ID and Client Secret. When asked for a redirect URI, enter https://labs.pathfix.com/integrate/command.
2
Add the credentials in Pathfix
In your Pathfix account, add an application, select Microsoft Mail from the providers and enter the Client ID and Client Secret.
3
Choose your scopes
Add only the scopes your integration needs. Microsoft’s developer documentation lists what each scope allows.
4
Test the connection
Use Test Connection to connect an account in the API Playground and run a sample call.
5
Let your users authorize
Add the connect step to your app. Each user signs in to Microsoft Mail and approves the scopes you requested.
6
Call the Microsoft Mail API
Send requests through the Pathfix passthrough API using the provider reference msgraphmail.