Microsoft OneDrive Connector

Microsoft OneDrive is a cloud storage service from Microsoft that allows you to store, sync, and share files across devices. This component allows you to manage drives, upload and download files, search content, and monitor changes in your Microsoft OneDrive account.

API Documentation

This component was built using the Microsoft Graph Rest API v1.0

Connections

OAuth 2.0

OAuth 2.0 Connectivity for Microsoft One Drive

Once you have an instance of Microsoft OneDrive licensed to your account, you will need to create and configure a new "App Registration" within your Azure Active Directory tenant. When creating the application you will be prompted to select the 'Supported account types'. Under this section, be sure to select 'Accounts in any organizational directory (Any Azure AD directory - Multitenant)'.

You will need to go to "Platforms" and add the "Web" platform. In that section you should add the OAuth 2.0 callback URL - https://oauth2.integrations.acme.com/callback - as a Redirect URI.

Next, go to "Certificates & Secrets" for the app and add a new Client Secret. Note this value as you will need to supply it to the connection.

You will also need the Application (client) ID from the "Overview" page.

The last step of configuring the "App Registration" is assigning "App Permissions". Click "Add Permission", click on the square labeled "Microsoft Graph", and then "Delegated permissions". You should select all permissions that are required for your desired integration.

Additionally, ensure the offline_access scope is included in your app registration. It is essential to maintain your OAuth connection and receive refresh tokens. Without it, users will need to re-authenticate every hour.

Now, configure the OAuth 2.0 connection. Add an MS OneDrive OAuth 2.0 connection config variable:

Use the Application (client) ID value for the Client ID field.
Use the Client Secret for the same named field.
If you didn't select Multitenant when creating the Azure application, you will need to replace the Authorize URL and Token URL with ones specific to your tenant.

Save your integration and you should be able to authenticate a user through MS OneDrive with OAuth 2.0.

Microsoft requires Azure AD app registrations used in multi-tenant deployments to complete a publisher verification process. This review confirms the app developer's identity, giving end users confidence that they are authorizing a legitimate, verified application.

Azure AD app registrations have two distinct verification concepts that affect how users experience the authentication flow.

Publisher Verification

Complete publisher verification before deploying to end users. Without it, the Microsoft consent screen displays "Unverified" next to the app name. This reduces user trust and may prevent users in organizations with strict Azure AD policies from being able to authorize the app at all.

To verify the publisher:

Ensure the organization has a Microsoft Partner Network (MPN) account
In the Microsoft Entra Admin Center, open the app registration
Under Branding & properties, click Add a verified publisher
Enter the MPN ID and confirm

Once verified, the consent screen displays the organization name with a verified badge instead of "Unverified."

Apps requesting application permissions (permissions that act without a signed-in user) or high-privilege delegated permissions require admin consent before any user in a Microsoft 365 tenant can authenticate. Without admin consent, users see a "Need admin approval" error.

A tenant administrator can grant consent using either method:

Method 1 — Admin Consent URL:

Navigate to the following URL, replacing {tenant} with the Directory tenant ID and {client_id} with the Application client ID:

https://login.microsoftonline.com/{tenant}/adminconsent?client_id={client_id}

Method 2 — Microsoft Entra Admin Center:

Navigate to Microsoft Entra Admin Center → Enterprise applications
Select the app registration
Under Permissions, click Grant admin consent for [organization name]

Delegated vs. Application Permissions

Delegated permissions (user-level) typically do not require admin consent unless they are classified as high privilege. Application permissions always require admin consent. Review the Microsoft Graph permissions reference to identify which permissions require consent.

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

Input	Comments	Default
Authorize URL	The OAuth 2.0 Authorization URL for Microsoft OneDrive.	https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL	The OAuth 2.0 Token URL for Microsoft OneDrive.	https://login.microsoftonline.com/common/oauth2/v2.0/token
Client ID	The Application (client) ID from your Azure AD app registration. Learn more.
Client Secret	The client secret value generated in your Azure AD app registration. Learn more.

Triggers

Drive Subscription

Receive webhook notifications from OneDrive drives. Automatically creates and manages a webhook subscription when the instance is deployed, and removes the subscription when the instance is deleted.

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Resource	The Microsoft Graph resource path to monitor. Examples: /me/drive/root, /drives/{drive-id}/root	/me/drive/root
Change Type	The type of changes to monitor. OneDrive primarily supports 'updated'.	updated
Client State	Optional validation token sent with each notification. Use to verify notifications originate from Microsoft Graph.
Expiration Date Time	Optional expiration date/time for the subscription. If not provided, defaults to 3 days from now. Maximum is 30 days for OneDrive resources.

Webhook

Receive and validate webhook requests from OneDrive for manually configured webhook subscriptions.

Actions

Create a Subscription

Create a Subscription to notify you of changes to a resource

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Change Type	The type of changes that should generate notifications for this subscription. OneDrive only supports 'updated'.	updated
Notification URL	The URL where webhook notifications will be delivered. Must be accessible from Microsoft Graph.
Resource	The Microsoft Graph resource path to monitor for changes. See Microsoft Graph documentation for valid resource paths.
Expiration Date Time	The date and time when the subscription expires in ISO 8601 format. Maximum is 30 days from now for OneDrive resources.
Client State	An optional validation token that is passed back in each notification for verification purposes.
Allow Duplicates	When true, allows multiple subscriptions for the same endpoint.	false

Delete all Instanced Subscriptions

Delete all existing subscriptions for this instance

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.

Delete a Subscription

Delete a Subscription by ID

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Subscription Id	The unique identifier of the subscription.

Delete File

Delete the information and metadata of a file by path

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Drive	The unique identifier of the drive.
Item Id	The unique identifier of the drive item (file or folder).

Download File

Download a file from the current user's drive

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
File Location	Provide a leading slash followed by the location of your file within the current user's drive.
Timeout	The maximum time in milliseconds to wait for a response.

Get Drive

Get the information and metadata of a drive

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Drive	The unique identifier of the drive.

Get Item

Returns the information and metadata of an existing item

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Drive	The unique identifier of the drive.
Item Id	The unique identifier of the drive item (file or folder).

Get Item by Path

Get the information and metadata of an item with your path in Sharepoint

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
File Location	Provide a leading slash, followed by the location and name of your file.

Get Site

Get the information and metadata of a given Site

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Site	The unique identifier of the SharePoint site.

List Changes

Track changes in a driveItem and its children over time.

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Delta URL	The URL to track changes in a driveItem and its children over time. You can also use the @odata.nextLink or @odata.deltaLink from a previous response to resume tracking changes. See Microsoft Graph delta query documentation.	/drives/{drive-id}/root/delta
$select Parameter	Comma-separated list of properties to include in the response. See Microsoft Graph $select documentation.
$expand Parameter	Comma-separated list of related resources to include in the response. See Microsoft Graph $expand documentation.
$top Parameter	The maximum number of results to return per page. See Microsoft Graph $top documentation.

List Children

Returns all child elements on a given drive item

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Drive	The unique identifier of the drive.
Item Id	The unique identifier of the drive item (file or folder).
Fetch All	When enabled, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Page Limit	The maximum number of results to return per page.
Page Token	The token for retrieving the next page of results.

List Drives By Group

Returns a list of all drives available to the given group

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Group	The unique identifier of the Microsoft 365 group.
Fetch All	When enabled, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Page Limit	The maximum number of results to return per page.
Page Token	The token for retrieving the next page of results.

List Drives By Site

Returns a list of all drives available to the given site

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Site	The unique identifier of the SharePoint site.
Fetch All	When enabled, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Page Limit	The maximum number of results to return per page.
Page Token	The token for retrieving the next page of results.

List Drives By User

Returns a list of all drives available to the given user

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
User	The unique identifier or email address of the user.
Fetch All	When enabled, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Page Limit	The maximum number of results to return per page.
Page Token	The token for retrieving the next page of results.

List Files Shared With Me (Deprecation Notice)

Returns all files shared with your account. Deprecated: the underlying Microsoft Graph endpoint is degraded and scheduled for removal around November 2026, and may return incomplete results. Use the "List Shared" action instead.

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Fetch All	When enabled, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Page Limit	The maximum number of results to return per page.
Page Token	The token for retrieving the next page of results.

List Groups

Returns a list of all groups the user has access to

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Fetch All	When enabled, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Page Token	The token for retrieving the next page of results.
Page Limit	The maximum number of results to return per page.

List Items In Directory

Returns a list of all items in the given directory

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Directory	The directory path of the file. Use a forward slash (/) to access the root directory.
Fetch All	When enabled, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Page Limit	The maximum number of results to return per page.
Page Token	The token for retrieving the next page of results.

List My Drives

Returns a list of all drives available to the current user

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Fetch All	When enabled, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Page Limit	The maximum number of results to return per page.
Page Token	The token for retrieving the next page of results.

List Shared

List shared items in SharePoint or OneDrive

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.

List Sites

Returns a list of all sites available to the current user

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Fetch All	When enabled, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Page Limit	The maximum number of results to return per page.
Page Token	The token for retrieving the next page of results.

List Subscriptions

List all available Subscriptions

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Show Instance Subscriptions	When true, shows only subscriptions associated with this instance.	true

Move File

Move the given file to a new location

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Current Location	Provide a leading slash, followed by the location and name of the file
New Location	Provide a leading slash, followed by the new location of the file.
New File Name	The new name for the file.

Raw Request

Send raw HTTP request to Microsoft Onedrive

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
URL	Input the path only (/me/drive), The base URL is already included (https://graph.microsoft.com/v1.0). For example, to connect to https://graph.microsoft.com/v1.0/me/drive, only /me/drive is entered in this field.
Method	The HTTP method to use.
Data	The HTTP body payload to send to the URL.
Form Data	The Form Data to be sent as a multipart form upload.
File Data	File Data to be sent as a multipart form upload.
File Data File Names	File names to apply to the file data inputs. Keys must match the file data keys above.
Query Parameter	A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Header	A list of headers to send with the request.
Response Type	The type of data you expect in the response. You can request json, text, or binary data.	json
Timeout	The maximum time that a client will await a response to its request
Retry Delay (ms)	The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.	0
Retry On All Errors	If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.	false
Max Retry Count	The maximum number of retries to attempt. Specify 0 for no retries.	0
Use Exponential Backoff	Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.	false

Renew Subscription

Extend the expiration date of an existing OneDrive subscription

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Subscription Id	The unique identifier of the subscription.
Expiration Days	Number of days to extend the subscription (1-30). Maximum is 30 days for OneDrive resources.	3

Search Drive

Search the current drive for a string of text

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
Search	The text to search for within the current drive.

Search Users

Find the information and metadata of an existing user

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
User	The unique identifier or email address of the user.

Update File

Update the information and metadata of a given file

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
File Location	Provide a leading slash, followed by the location and name of the file.
New File Name	The new name for the file.
New File Path	The path to the desired SharePoint resource. The root directory does not need to be included.
Optional Values	Optional key-value pairs to include in the request body.

Upload File

Upload a file to the user's connected drive

Input	Comments	Default
Connection	The Microsoft OneDrive connection to use.
File Location	Provide a leading slash, followed by the location and name of the new file.
File Data	The binary content of the file to upload.
Timeout	The maximum time in milliseconds to wait for a response.

API Documentation​

Connections​

OAuth 2.0​

App Verification and Admin Consent​

Publisher Verification​

Admin Consent​

Triggers​

Drive Subscription​

Webhook​

Actions​

Create a Subscription​

Delete all Instanced Subscriptions​

Delete a Subscription​

Delete File​

Download File​

Get Drive​

Get Item​

Get Item by Path​

Get Site​

List Changes​

List Children​

List Drives By Group​

List Drives By Site​

List Drives By User​

List Files Shared With Me (Deprecation Notice)​

List Groups​

List Items In Directory​

List My Drives​

List Shared​

List Sites​

List Subscriptions​

Move File​

Raw Request​

Renew Subscription​

Search Drive​

Search Users​

Update File​

Upload File​