OneDrive for Business - Nango Docs

🚀 Quickstart

Connect to OneDrive for Business with Nango and see data flow in 2 minutes.

1

Create the integration

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

2

Authorize OneDrive for Business

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

3

Call the OneDrive for Business API

Let’s make your first request to the OneDrive for Business API. Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/v1.0/me/drives" \
  -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/drives',
    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.

4

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.

📚 OneDrive for Business Integration Guides

Nango maintained guides for common use cases.

How to register your own OneDrive for Business 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 OneDrive for Business

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

Drive Items

Function name	Description	Type	Source code
`list-children`	List items under a folder	Action	🔗 Github
`list-recent-items`	List recently used items from the user drive.	Action	🔗 Github
`search-items`	Search drive items by keyword	Action	🔗 Github
`update-item`	Update mutable file or folder metadata.	Action	🔗 Github

Drives

Function name	Description	Type	Source code
`get-drive`	Retrieve the user drive metadata.	Action	🔗 Github
`list-drives`	List drives available to the authenticated user.	Action	🔗 Github

Files

Function name	Description	Type	Source code
`create-folder`	Create a folder in OneDrive.	Action	🔗 Github
`create-sharing-link`	Create a share link for a file or folder.	Action	🔗 Github
`create-upload-session`	Start a resumable upload for a large file.	Action	🔗 Github
`list-shared-items`	List items shared with the user.	Action	🔗 Github
`list-versions`	List versions for a file.	Action	🔗 Github
`move-item`	Move or rename a file or folder	Action	🔗 Github
`upload-small-file`	Upload a small file in a single request.	Action	🔗 Github

Items

Function name	Description	Type	Source code
`copy-item`	Copy a file or folder to another location	Action	🔗 Github
`delete-item`	Delete a file or folder.	Action	🔗 Github
`get-item`	Retrieve a file or folder by ID or path	Action	🔗 Github

Permissions

Function name	Description	Type	Source code
`get-permission`	Retrieve a sharing permission on an item	Action	🔗 Github
`list-permissions`	List sharing permissions on an item	Action	🔗 Github

Function name	Description	Type	Source code
`invite-recipients`	Grant item access to recipients and optionally send invitations.	Action	🔗 Github

Others

Function name	Description	Type	Source code
`delete-permission`	Remove a sharing permission from an item	Action	🔗 Github
`drive-items`	Sync the OneDrive file and folder hierarchy using drive root delta.	Sync	🔗 Github
`folder-children`	Sync children for selected folders	Sync	🔗 Github
`recent-items`	Sync recently used drive items from OneDrive	Sync	🔗 Github
`shared-items`	Sync items shared with the user	Sync	🔗 Github
`user-files-selection`	Sync selected OneDrive files from metadata	Sync	🔗 Github
`user-files`	Sync file metadata from the user OneDrive	Sync	🔗 Github

OnLogist OneDrive Personal

⌘I