🚀 Quickstart
Connect to Microsoft Graph with Nango and see data flow in 2 minutes.1
Create the integration
In Nango (free signup), go to Integrations -> Configure New Integration -> Microsoft (Admin - Certificate). Enter your app’s client ID, paste the private key (
private_key.pem) in the Client secret field and the certificate (certificate.pem) in the Certificate field, and set the scopes to https://graph.microsoft.com/.default. See how to register your own app.3
Call the Microsoft Graph API
Let’s make your first request to the Microsoft Graph API to read the connected organization (the app needs the Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.
Organization.Read.All or Directory.Read.All application permission). Replace the placeholders below with your Environment API key, integration ID, and connection ID:- cURL
- Node
4
Implement Nango in your app
Follow our Auth implementation guide to integrate Nango in your app.
📚 Microsoft (Admin - Certificate) integration guides
- How to register your own Microsoft app with a certificate
Register a Microsoft Entra app, upload a certificate and connect its credentials to Nango. - How do I link my account?
Find your tenant ID and grant admin consent.
API gotchas
- This is the same admin-consent flow as Microsoft Admin, but Nango proves the app’s identity with a JWT signed by your certificate’s private key instead of a client secret. Use it when your organization does not allow client secrets.
- Only an administrator of the tenant can authorize the connection, since admin consent grants the app’s permissions for the whole organization.
- The app only gets Application permissions. Use the
https://graph.microsoft.com/.defaultscope, which requests every application permission granted to the app;.defaultcan’t be combined with other scopes. - When the certificate expires or you replace it, upload the new certificate in Microsoft Entra and update both the private key and the certificate in the Nango integration.