Microsoft - Nango Docs

🚀 Quickstart

Connect to Microsoft with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Microsoft.

Authorize Microsoft

Go to Connections -> Add Test Connection -> Authorize, then log in to Microsoft. Later, you’ll let your users do the same directly from your app.

Call the Microsoft API

Let’s make your first request to the Microsoft Graph API (fetch the current user’s profile). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/v1.0/me" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/v1.0/me',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Microsoft Integration Guides

Nango maintained guides for common use cases.

How to register your own Microsoft OAuth app
Register an OAuth app with Microsoft and obtain credentials to connect it to Nango

Official docs: Microsoft Graph API documentation

🧩 Pre-built syncs & actions for Microsoft

Enable them in your dashboard. Extend and customize to fit your needs.

Applications

Function name	Description	Type	Source code
`create-application`	Create a new application in Microsoft Entra ID	Action	🔗 Github
`delete-application`	Delete or archive an application in Microsoft.	Action	🔗 Github
`get-application`	Retrieve a single application from Microsoft.	Action	🔗 Github
`list-applications`	List applications from Microsoft Graph API	Action	🔗 Github
`update-application`	Update an application in Microsoft Entra	Action	🔗 Github

Devices

Function name	Description	Type	Source code
`list-devices`	List devices from Microsoft Graph	Action	🔗 Github

Function name	Description	Type	Source code
`list-directory-roles`	List directory roles from Microsoft Graph. Returns activated directory roles in the tenant.	Action	🔗 Github

Directory Roles

Function name	Description	Type	Source code
`get-directory-role`	Retrieve a single directory role from Microsoft.	Action	🔗 Github
`list-directory-role-members`	List all members (users and service principals) assigned to a directory role in Microsoft.	Action	🔗 Github

Groups

Function name	Description	Type	Source code
`add-group-member`	Add a member (user, group, or service principal) to a group in Microsoft.	Action	🔗 Github
`create-group`	Create a group in Microsoft	Action	🔗 Github
`delete-group`	Delete or archive a group in Microsoft	Action	🔗 Github
`get-group`	Retrieve a single group from Microsoft.	Action	🔗 Github
`list-group-members`	List all direct members of a group in Microsoft	Action	🔗 Github
`list-groups`	List groups from Microsoft	Action	🔗 Github
`remove-group-member`	Remove a member from a group in Microsoft.	Action	🔗 Github

Organizations

Function name	Description	Type	Source code
`get-organization`	Retrieve a single organization from Microsoft.	Action	🔗 Github
`list-organizations`	List organizations from Microsoft Graph.	Action	🔗 Github
`update-organization`	Update the properties of a Microsoft organization.	Action	🔗 Github

Service Principals

Function name	Description	Type	Source code
`create-service-principal`	Create a service principal in Microsoft Entra ID for an existing application.	Action	🔗 Github
`delete-service-principal`	Delete a service principal in Microsoft Entra ID	Action	🔗 Github
`get-service-principal`	Retrieve a single service principal from Microsoft.	Action	🔗 Github
`list-service-principals`	List service principals from Microsoft Graph	Action	🔗 Github
`update-service-principal`	Update a service principal in Microsoft Entra ID.	Action	🔗 Github

Users

Function name	Description	Type	Source code
`create-user`	Create a user in Microsoft Azure AD	Action	🔗 Github
`delete-user`	Delete or archive a user in Microsoft	Action	🔗 Github
`get-user`	Retrieve a single user from Microsoft	Action	🔗 Github
`list-user-memberships`	List all groups, directory roles, and administrative units that a user is a member of in Microsoft.	Action	🔗 Github
`list-users`	List users from Microsoft	Action	🔗 Github
`update-user`	Update a user in Microsoft Entra ID	Action	🔗 Github

Others

Function name	Description	Type	Source code
`update-group`	Update a group in Microsoft.	Action	🔗 Github
`applications`	Sync applications from Microsoft Graph	Sync	🔗 Github
`directory-roles`	Sync directory roles from Microsoft	Sync	🔗 Github
`groups`	Sync groups from Microsoft Graph with incremental delta tracking	Sync	🔗 Github
`organizations`	Sync organizations from Microsoft	Sync	🔗 Github
`service-principals`	Sync service principals from Microsoft Graph	Sync	🔗 Github
`users`	Sync users from Microsoft	Sync	🔗 Github

Documentation Index

​🚀 Quickstart

​📚 Microsoft Integration Guides

​🧩 Pre-built syncs & actions for Microsoft

​Applications

​Devices

​Directory

​Directory Roles

​Groups

​Organizations

​Service Principals

​Users

​Others