Skip to main content

🚀 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.
2

Authorize Microsoft

Go to Connections -> Add Test Connection -> Authorize, enter the tenant ID, then sign in as an administrator of that tenant and accept the permissions. Later, you’ll let your users do the same directly from your 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 Organization.Read.All or Directory.Read.All application permission). Replace the placeholders below with your Environment API key, integration ID, and connection ID:
Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.
4

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.

📚 Microsoft (Admin - Certificate) integration guides

Official docs: Microsoft identity platform certificate credentials

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/.default scope, which requests every application permission granted to the app; .default can’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.

🧩 Pre-built syncs & tools for Microsoft (Admin - Certificate)

Explore Nango-provided tools in your dashboard. Extend and customize them to fit your needs. No pre-built syncs or tools available yet.
Not seeing the integration you need? Build your own independently.