OneDrive Personal

Access the OneDrive Personal API in 2 minutes 💨

🚀 Quickstart

1. Create an integration

   In Nango (free signup), go to Integrations -> Configure New Integration -> OneDrive Personal. Nango doesn’t provide a test OAuth app for OneDrive Personal yet. You’ll need to set up your own by following these instructions. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Nango.

2. Authorize OneDrive

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

3. Call the OneDrive API

   Let’s make your first request to the OneDrive API (get drive information). Replace the placeholders below with your secret key, integration ID, and connection ID:

   cURL

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

   Node

   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/drive',
       providerConfigKey: '<INTEGRATION-ID>',
       connectionId: '<CONNECTION-ID>'
   });
   
   console.log(JSON.stringify(res.data, null, 2));
   

   Or fetch credentials dynamically via the Node SDK or API.

✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Next step: Embed the auth flow in your app to let your users connect their OneDrive accounts.

🧑‍💻 OAuth app setup

1. Create a Microsoft account and Azure account

   If you don’t already have them, sign up for a Microsoft account and an Azure account.

2. Register an application in Microsoft Entra ID

   1. Sign in to the Microsoft Entra admin center as at least an Application Developer.
   2. If you have access to multiple tenants, use the Settings icon in the top menu to switch to the tenant in which you want to register the application.
   3. From the search bar at the top of the Azure portal, search for App registrations and select it. Then choose New registration. Or from your left navigation tab, navigate to Applications > App registrations then choose New registration.
   4. Enter a meaningful name for your application, for example “Nango Integration”.
   5. Under Supported account types, select the appropriate option based on your needs:
      • Personal Microsoft accounts only - For apps that only need to access OneDrive Personal accounts.
      • Accounts in any organizational directory and personal Microsoft accounts - For multitenant apps that support both organizational and personal Microsoft accounts.
   6. Leave the Redirect URI section blank for now; we’ll configure it in a later step.
   7. Click Register to complete the app registration.
3. Note your application (client) ID

   After registration, you’ll be taken to the application’s Overview page. Record the Application (client) ID, which uniquely identifies your application and is used in your application’s code as part of validating security tokens.

4. Add a redirect URI

   1. In the left sidebar, select Authentication.
   2. Under Platform configurations, select Add a platform.
   3. Select Web as the platform type.
   4. Enter https://api.nango.dev/oauth/callback as the Redirect URI.
   5. Under Implicit grant and hybrid flows, check the boxes for Access tokens and ID tokens if your application needs them.
   6. Under Advanced settings, set Allow public client flows to No for web applications.
   7. Click Configure to save your changes.
5. Create a client secret

   1. In the left sidebar, select Certificates & secrets.
   2. Under Client secrets, click New client secret.
   3. Enter a description for the secret and select an expiration period (6 months, 12 months, 24 months, or custom).
   4. Click Add.
   5. Important: Copy the secret value immediately and store it securely. You won’t be able to see it again after you leave this page.
6. Next

   Follow the Quickstart.

Common Scopes

Scope	Description
OneDrive.Read	Read the signed-in user’s OneDrive files
OneDrive.ReadWrite	Read and write the signed-in user’s OneDrive files
OneDrive.AppFolder	Read and write files in the application’s special OneDrive folder
offline_access	Access to refresh tokens for offline access

Complete Integration Implementation

For a complete, production-ready implementation of OneDrive Personal integration with Nango, check out the Nango Sample App.

The sample app provides:

• Full OAuth flow implementation
• OneDrive file picker integration
• File syncing with webhooks
• File download functionality
• Complete frontend and backend code examples

You can also watch a demo video walkthrough or view the GitHub repository.

The sample app is the fastest way to get started with OneDrive Personal integration. It includes all the code you need and can be customized for your specific use case.

🔗 Useful links

Topic	Links
General	Microsoft Entra Admin Center
	Azure Portal
Developer	Microsoft identity platform documentation
	How to register an Application
	OAuth 2.0 Authorization Code Flow
	OneDrive API for Consumer accounts
	OneDrive Permissions
	OneDrive Consumer Configuration for the File Picker

Contribute useful links by editing this page

🚨 API gotchas

• Make sure you request the offline_access scope to get a refresh token and keep access with your integration.
• OneDrive Personal uses https://api.onedrive.com as its base URL for API calls.
• If you need a user to reauthenticate or accept updated scopes, you can force a prompt using the authorization_params. Use prompt=login to force the user to enter their credentials (bypassing single sign-on) or prompt=consent to trigger the OAuth consent dialog after sign-in, which asks the user to grant permissions to the app. For more details, see Microsoft’s OAuth 2.0 authorization documentation.

const { data } = await nango.createConnectSession({
  [...],
  integrations_config_defaults: {
    "one-drive-personal": {
      authorization_params: {
        "prompt": "consent" // or "login" depending on your needs
      }
    }
  }
});

Contribute API gotchas by editing this page

Questions? Join us in the Slack community.