Microsoft OneDrive Connector

Source npm · v0.2.0 API Docs API Changelog Connector Changelog

Description

Microsoft OneDrive is a cloud storage service from Microsoft that enables storing, syncing, and sharing files across devices. This component enables managing drives, uploading and downloading files, searching content, and monitoring changes in a Microsoft OneDrive account.

API Documentation

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

Connections

OAuth 2.0

key: oauth

This connection authenticates to Microsoft OneDrive with OAuth 2.0 through an Azure app registration.

Prerequisites

A Microsoft Entra ID (Azure AD) tenant with an account licensed for Microsoft OneDrive
Permission to create an app registration in that tenant

Setup Steps

In the Azure portal, create a new App registration. Under Supported account types, select Any Entra ID tenant + Personal Microsoft accounts so both work and school and personal OneDrive accounts can authenticate.
Open Authentication, add the Web platform, and add the OAuth 2.0 callback URL https://oauth2.prismatic.io/callback as a Redirect URI.
Open Certificates & secrets and add a new Client secret. Copy the secret value; it is shown only once.
Copy the Application (client) ID from the Overview page.
Open API permissions, click Add a permission, choose Microsoft Graph, then Delegated permissions, and select the permissions the integration requires. Include offline_access; without it refresh tokens are not issued and users must re-authenticate every hour.

Configure the Connection

Create a connection of type OAuth 2.0:

Client ID: the Application (client) ID
Client Secret: the client secret value
Scopes: the default scopes cover files, sites and refresh tokens; add others the integration requires
Authorize URL and Token URL: keep the defaults for a multitenant app. For a single-tenant app registration, replace both with the tenant-specific URLs.

Save the integration. Users can then authenticate through Microsoft 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. Delegated permissions rarely need admin consent unless classified as high privilege; see the Microsoft Graph permissions reference to check which do.

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]

Input	Notes	Example
Authorize URL	The OAuth 2.0 Authorization URL for Microsoft OneDrive.	https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Client ID	The Application (client) ID from the Azure AD app registration. Learn more.	12345678-1234-1234-1234-123456789012
Client Secret	The client secret value generated in the Azure AD app registration. Learn more.
Scopes	Space-separated list of Microsoft Graph permission scopes. Scopes are configured on the Azure AD application registration. Learn more.	https://graph.microsoft.com/Files.Read https://graph.microsoft.com/Files.ReadWrite https://graph.microsoft.com/Sites.ReadWrite.All offline_access
Source		OneDrive
Token URL	The OAuth 2.0 Token URL for Microsoft OneDrive.	https://login.microsoftonline.com/common/oauth2/v2.0/token

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. Supports scheduled renewal to keep the subscription active. | key: instanceDeployWebhook

Input	Notes	Example
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.	client-specific-validation-token
Expiration Date Time	Optional expiration date/time for the subscription. If not provided, defaults to about 7 days from now. Set a schedule on the trigger to renew the subscription before it expires. Maximum is just under 30 days (42,300 minutes) for OneDrive resources.	2025-12-31T23:59:59.000Z
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

The Drive Subscription trigger automatically creates and manages webhook subscriptions for OneDrive resources throughout the instance lifecycle. Unlike the manual Webhook trigger, this trigger handles all subscription operations automatically, eliminating the need for manual configuration in the Azure portal or Microsoft Graph API.

When the trigger is configured in a flow:

On Instance Deploy: Automatically creates a webhook subscription in Microsoft Graph for the specified OneDrive resource. The subscription points to the instance's unique webhook URL and monitors the configured change types.
On Scheduled Execution: Renews the subscription before it expires, or creates a new one if it has already lapsed. Set a schedule on the trigger to keep notifications flowing.
On Lifecycle Notification: Answers Microsoft Graph's reauthorizationRequired challenges by renewing the subscription, and recreates the subscription if Microsoft Graph ever reports it removed.
On Instance Deletion: Automatically removes all webhook subscriptions created by this instance, ensuring clean resource management.

This trigger is ideal for production integrations where webhook lifecycle should be managed automatically alongside the integration instance.

How It Works

Automatic Subscription Creation:

When an instance containing this trigger is deployed, the trigger creates a webhook subscription via the Microsoft Graph API, registering the flow's webhook URL for both change notifications and lifecycle notifications
Microsoft Graph validates the webhook endpoint by sending a validation request with a validationToken query parameter
The trigger responds with the validation token to complete the handshake
The subscription becomes active and begins monitoring the specified OneDrive resource

Notification Processing:

When changes occur to the monitored resource, Microsoft Graph sends webhook notifications to the instance
The trigger validates the clientState value (if configured) to ensure notifications originate from Microsoft Graph
Notifications route to the "Notification" branch for processing
The integration uses the notification to trigger delta queries that identify specific changes

Subscription Renewal:

Microsoft Graph subscriptions expire. Without renewal, notifications stop about 7 days after deployment, or at the configured expiration
When the trigger runs on a schedule, it extends the subscription expiration to 10 minutes under the Microsoft Graph maximum for drive resources (42,300 minutes, just under 30 days) and routes the execution to the "Scheduled Renewal" branch
If the subscription has already expired, the scheduled run creates a new one
Microsoft Graph also sends reauthorizationRequired lifecycle notifications to the flow's webhook URL, which the trigger answers by renewing the subscription. Microsoft documents that these notifications do not replace renewal, so the schedule remains the reliable way to keep a subscription active

Automatic Subscription Cleanup:

When the instance is deleted, the trigger automatically removes all webhook subscriptions
This prevents orphaned subscriptions and ensures clean resource management

Configuration

Connection:

OneDrive Connection: OAuth connection with permission to read the drive being monitored (Files.Read.All for OneDrive for Business, Files.Read for a personal Microsoft account). Creating the subscription needs no extra permission.

Subscription Settings:

Resource: The Microsoft Graph resource path to monitor. Examples:
- /me/drive/root - Current user's root drive folder
- /drives/{drive-id}/root - Specific drive's root folder
- /me/drive/items/{item-id} - Specific folder (personal OneDrive only; OneDrive for Business supports only the root folder)
Change Type: The type of changes to monitor. OneDrive primarily supports updated for drive resources.
Client State: Optional validation token sent with each notification. Use to verify notifications originate from Microsoft Graph. The trigger logs a warning if the received clientState doesn't match the expected value.
Expiration Date Time: Optional expiration date/time for the subscription. If not provided, defaults to about 7 days from now. Maximum is just under 30 days (42,300 minutes) for OneDrive resources. Set a schedule on the trigger to renew the subscription before it expires.

Event Types

Available Events (1)

Event	Description
`updated`	Sent when an item in the monitored drive hierarchy is created, changed, or deleted. Drive root subscriptions support only this change type.

Lifecycle Events (3)

Event	Description
`reauthorizationRequired`	Microsoft Graph asks the subscription to be reauthorized, for example before it expires. The trigger renews the subscription.
`subscriptionRemoved`	Microsoft Graph removed the subscription. The trigger creates a new one.
`missed`	Some change notifications were not delivered. The trigger passes the notice to the flow; run a delta query to catch up.

For drive resources Microsoft Graph currently sends only reauthorizationRequired; the other two are handled if they arrive. See the Microsoft Graph change notifications overview and the lifecycle notifications guide.

Branches

The trigger uses branching to handle different request types:

URL Validation: Activated during subscription creation when Microsoft Graph validates the webhook endpoint. The trigger automatically responds with the validation token.
Notification: Activated when OneDrive sends change notifications. Process these notifications to identify what changed in the monitored resource.
Scheduled Renewal: Activated when the trigger runs on its configured schedule. The trigger renews the subscription, or creates a new one if none remains. No steps are required on this branch.
Lifecycle Event: Activated when Microsoft Graph posts a lifecycle notification. For drive resources Microsoft Graph currently sends only reauthorizationRequired; the trigger also handles subscriptionRemoved and missed if they arrive. The trigger renews or recreates the subscription as needed and responds with HTTP 202. When Client State is set, a lifecycle notice that carries a different value is still acknowledged with HTTP 202 and reaches this branch, but the trigger does not renew or recreate the subscription for it. A missed notice means some change notifications were not delivered; run a delta query to catch up.

Returned Data

URL Validation Branch:

During subscription creation, Microsoft Graph validates the endpoint:

Validation Request

{
  "queryParameters": {
    "validationToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1..."
  }
}

The trigger automatically responds with HTTP 200 and the token in plain text.

Notification Branch:

Change notifications contain subscription metadata but not change details:

Notification Payload

{
  "body": {
    "data": {
      "value": [
        {
          "subscriptionId": "A640DFF3-0429-44FC-AF7E-30523A476864",
          "expirationDateTime": "2025-02-22T16:00:00Z",
          "resource": "/me/drive/root",
          "clientState": "client-specific string"
        }
      ]
    }
  }
}

Use the delta API to query for specific changes after receiving a notification.

Lifecycle Event Branch:

Lifecycle notifications describe the subscription rather than a changed resource:

Lifecycle Notification Payload

{
  "body": {
    "data": {
      "value": [
        {
          "subscriptionId": "A640DFF3-0429-44FC-AF7E-30523A476864",
          "subscriptionExpirationDateTime": "2025-02-22T16:00:00Z",
          "tenantId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "clientState": "client-specific string",
          "lifecycleEvent": "reauthorizationRequired"
        }
      ]
    }
  }
}

Best Practices

Subscription Renewal: OneDrive subscriptions expire after about 7 days by default and after just under 30 days (42,300 minutes) at most. Configure the trigger with a schedule (for example, daily) so it renews the subscription before it expires. Each renewal extends the subscription to the 42,300-minute maximum, so any schedule shorter than that keeps it active.
Resource Scope: On personal OneDrive, subscribe to the most specific folder needed, because the root generates more notifications than a single folder. OneDrive for Business supports only the root folder.
Client State Validation: Configure a unique clientState value to verify notification authenticity. The trigger logs warnings for mismatched values.
Delta Queries: Webhook notifications indicate changes occurred but don't specify what changed. Implement delta query logic to identify specific changes after receiving notifications.
Error Handling: Monitor logs for subscription creation failures. Common issues include insufficient permissions or invalid resource paths.
Multiple Instances: Each instance creates separate subscriptions. If deploying multiple instances monitoring the same resource, ensure the integration handles duplicate notifications appropriately.

Notes

Subscriptions are automatically created when the instance is deployed and deleted when the instance is removed
OneDrive only supports changeType: "updated" for drive resources
Personal OneDrive allows subscriptions to any folder; OneDrive for Business only allows root folder subscriptions
The default expiration is about 7 days; maximum is just under 30 days (42,300 minutes) for OneDrive resources
The trigger validates clientState if configured and logs warnings for mismatches
Microsoft Graph retries failed webhook deliveries with exponential backoff for up to 4 hours
The platform automatically URL-decodes query parameters before passing them to the trigger

For complete details on OneDrive webhooks and subscriptions, see:

Example Payload for Drive Subscription⤓

Loading…

Webhook

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

The Webhook trigger receives and validates webhook notifications from OneDrive for webhooks that are manually configured in the Microsoft Azure portal or through the Microsoft Graph API. This trigger handles both the initial URL validation handshake and incoming change notifications.

Use this trigger when the integration needs to manually manage webhook subscriptions outside of the instance lifecycle, or when fine-grained control over subscription management is required. For automatic subscription management, use the Drive Subscription trigger instead.

How It Works

The trigger operates in two distinct modes based on the type of request received:

URL Validation Mode (Branch: "URL Validation"):

Microsoft Graph sends a validation request with a validationToken query parameter
The trigger extracts and returns the validation token in plain text with HTTP 200 status
This completes the subscription validation handshake required by Microsoft Graph

Notification Mode (Branch: "Notification"):

OneDrive sends webhook notifications when monitored resources change
The trigger receives the notification payload and routes it to the "Notification" branch
The integration can process the notification to identify what changed

Configuration

This trigger requires webhook subscriptions to be created manually using the Microsoft Graph API or Azure portal. Configure the subscription with:

Subscription Fields (5)

notificationUrl: The webhook URL provided by the instance
resource: The OneDrive resource path to monitor (e.g., /me/drive/root)
changeType: The type of changes to monitor (updated for OneDrive)
expirationDateTime: When the subscription expires (maximum just under 30 days, 42,300 minutes, for OneDrive)
clientState: Optional validation string sent with each notification

The trigger automatically handles URL validation when the subscription is created.

Event Types

Available Events (1)

Event	Description
`updated`	Sent when an item in the monitored drive hierarchy is created, changed, or deleted. Drive root subscriptions support only this change type.

See the Microsoft Graph change notifications overview for the full list of supported resources.

Branches

The trigger uses branching to handle different request types:

URL Validation: Activated when Microsoft Graph validates the webhook endpoint during subscription creation. The trigger automatically responds with the validation token.
Notification: Activated when OneDrive sends change notifications. Process these notifications to determine what changed.

Returned Data

URL Validation Branch:

The validation branch receives a query parameter and returns it as plain text:

Validation Request

{
  "queryParameters": {
    "validationToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1..."
  }
}

The trigger automatically responds with HTTP 200 and the token in plain text to complete validation.

Notification Branch:

The notification branch receives webhook payloads containing subscription information:

Notification Payload

{
  "body": {
    "data": {
      "value": [
        {
          "subscriptionId": "A640DFF3-0429-44FC-AF7E-30523A476864",
          "expirationDateTime": "2025-02-22T16:00:00Z",
          "resource": "/me/drive/root",
          "clientState": "client-specific string"
        }
      ]
    }
  }
}

The notification does not include change details. Use the delta API to query for specific changes after receiving a notification.

Best Practices

Respond Quickly: Microsoft Graph expects a response within 3 seconds. Queue notifications for processing rather than performing lengthy operations during the webhook request.
Validate clientState: If configured, verify the clientState value matches the expected value to ensure notifications originate from Microsoft Graph.
Handle Retries: Microsoft Graph retries failed webhook deliveries with exponential backoff for up to 4 hours. Ensure the endpoint returns appropriate status codes.
Monitor Expiration: OneDrive subscriptions expire after a maximum of just under 30 days (42,300 minutes). Implement a process to renew subscriptions before expiration.
Use Delta Queries: Webhook notifications indicate something changed but don't specify what. Use the delta query API to identify specific changes.

Notes

OneDrive only supports changeType: "updated" for drive resources
Personal OneDrive allows subscriptions to any folder; OneDrive for Business only allows root folder subscriptions
Maximum subscription duration is just under 30 days (42,300 minutes) for OneDrive resources
The platform automatically URL-decodes query parameters before passing them to the trigger

For complete details on OneDrive webhooks, see the Microsoft Graph webhooks documentation and OneDrive webhook concepts.

Example Payload for Webhook⤓

Loading…

Data Sources

List Drives from Source

Lists available drives for an account. | key: listDrives | type: picklist

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.

Example Payload for List Drives from Source⤓

Loading…

List Files in Directory

Lists files in a given directory. | key: listFilesInDirectory | type: picklist

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Directory	The directory path of the file. Use a forward slash (/) to access the root directory.	/myFolder/examples

Example Payload for List Files in Directory⤓

Loading…

List Folders from Source

Lists folders in a given directory. | key: listFolders | type: picklist

Input	Notes	Example
Directory	The directory path of the file. Use a forward slash (/) to access the root directory.	/myFolder/examples
Connection	The Microsoft OneDrive connection to use.

Example Payload for List Folders from Source⤓

Loading…

List Groups from Source

Lists available groups for an account. | key: listGroups | type: picklist

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.

Example Payload for List Groups from Source⤓

Loading…

List Users from Source

Lists available users for an account. | key: listUsers | type: picklist

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.

Example Payload for List Users from Source⤓

Loading…

Select Drive Item

A picklist of the files and folders at the top level of the specified drive. | key: selectDriveItem | type: picklist

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Drive ID	The unique identifier of the drive.	b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7

Example Payload for Select Drive Item⤓

Loading…

Select Drives from Sites

Select one or many drives from the specified sites. | key: selectDrivesFromSites | type: objectSelection

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Site IDs	The SharePoint sites whose drives populate the list. Accepts a single site ID, a list of site IDs, or a selection of sites.	contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740

Example Payload for Select Drives from Sites⤓

Loading…

Select Folders from Drives

Select one or many top-level folders from the specified drives. Each key is the drive ID and the folder ID joined by a colon. | key: selectFoldersFromDrives | type: objectSelection

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Drive IDs	The drives whose top-level folders populate the list. Accepts a single drive ID, a list of drive IDs, or a selection of drives.	b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7

Example Payload for Select Folders from Drives⤓

Loading…

Select Site

Lists sites available to the current user. | key: selectSite | type: picklist

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.

Example Payload for Select Site⤓

Loading…

Select Sites

Select one or many SharePoint sites. | key: selectSites | type: objectSelection

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.

Example Payload for Select Sites⤓

Loading…

Select Subscription

Lists subscriptions available to the current user. | key: selectSubscription | type: picklist

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.

Example Payload for Select Subscription⤓

Loading…

Actions

Create Subscription

Creates a subscription to receive notifications about changes to a resource. | key: createSubscription

Input	Notes	Example
Allow Duplicates	When true, allows multiple subscriptions for the same endpoint.	false
Change Type	The type of changes that should generate notifications for this subscription. OneDrive only supports 'updated'.	updated
Client State	An optional validation token that is passed back in each notification for verification purposes.	client-specific-validation-token
Expiration Date Time	The date and time when the subscription expires in ISO 8601 format. Maximum is just under 30 days (42,300 minutes) from now for OneDrive resources.	2025-12-31T23:59:59.000Z
Notification URL	The URL where webhook notifications will be delivered. Must be accessible from Microsoft Graph.	https://contoso.azurewebsites.net/api/webhook-receiver
Connection	The Microsoft OneDrive connection to use.
Resource	The Microsoft Graph resource path to monitor for changes. See Microsoft Graph documentation for valid resource paths.	/me/drive/root

Example Payload for Create Subscription⤓

Loading…

Delete All Instanced Subscriptions

Deletes all existing subscriptions for this instance. | key: deleteSubscriptions

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.

Example Payload for Delete All Instanced Subscriptions⤓

Loading…

Delete File

Deletes a file by drive ID and item ID. | key: deleteFile

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Drive ID	The unique identifier of the drive.	b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7
Item ID	The unique identifier of the drive item (file or folder).	01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK

Example Payload for Delete File⤓

Loading…

Delete Subscription

Deletes a subscription by ID. | key: deleteSubscription

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Subscription ID	The unique identifier of the subscription.	48bf81d7-2d37-40a9-b47b-c1d1960d00f87

Example Payload for Delete Subscription⤓

Loading…

Download File

Downloads a file from the current user's drive. | key: downloadFile

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
File Location	Provide a leading slash followed by the location of the file within the current user's drive.	/folder1/myExampleFile.csv
Timeout	The maximum time in milliseconds to wait for a response.	3000

Example Payload for Download File⤓

Loading…

Get Drive

Gets the information and metadata of a drive. | key: getDrive

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Drive ID	The unique identifier of the drive.	b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7

Example Payload for Get Drive⤓

Loading…

Get Item

Returns the information and metadata of an existing item. | key: getItemById

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Drive ID	The unique identifier of the drive.	b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7
Item ID	The unique identifier of the drive item (file or folder).	01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK

Example Payload for Get Item⤓

Loading…

Get Item by Path

Gets the information and metadata of an item by its path in the current user's OneDrive. | key: getItem

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
File Location	Provide a leading slash, followed by the location and name of the file.	/folder1/myFile.txt

Example Payload for Get Item by Path⤓

Loading…

Get Site

Gets the information and metadata of a given site. | key: getSite

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Site ID	The unique identifier of the SharePoint site.	contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740

Example Payload for Get Site⤓

Loading…

List Changes

Tracks changes in a driveItem and its children over time. | key: listChanges

Input	Notes	Example
Delta URL	The URL to track changes in a driveItem and its children over time. The @odata.nextLink or @odata.deltaLink from a previous response can also be used to resume tracking changes. See Microsoft Graph delta query documentation.	/drives/{drive-id}/root/delta
Connection	The Microsoft OneDrive connection to use.
Query Parameters	OData system query options to shape the delta query results.

Example Payload for List Changes⤓

Loading…

List Children

Returns all child elements on a given drive item. | key: listChildren

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Drive ID	The unique identifier of the drive.	b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7
Fetch All	When true, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Item ID	The unique identifier of the drive item (file or folder).	01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK
Pagination	Page-size and page-token controls for paging through results.

Example Payload for List Children⤓

Loading…

List Drives By Group

Returns a list of all drives available to the given group. | key: listDrivesByGroup

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Fetch All	When true, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Group ID	The unique identifier of the Microsoft 365 group.	b320ee12-b1cd-4cca-b648-a437be61c5cd
Pagination	Page-size and page-token controls for paging through results.

Example Payload for List Drives By Group⤓

Loading…

List Drives By Site

Returns a list of all drives available to the given site. | key: listDrivesBySite

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Fetch All	When true, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Pagination	Page-size and page-token controls for paging through results.
Site ID	The unique identifier of the SharePoint site.	contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740

Example Payload for List Drives By Site⤓

Loading…

List Drives By User

Returns a list of all drives available to the given user. | key: listDrivesByUser

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Fetch All	When true, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Pagination	Page-size and page-token controls for paging through results.
User ID or Email	The unique identifier or email address of the user.	87d349ed-44d7-43e1-9a83-5f2406dee5bd

Example Payload for List Drives By User⤓

Loading…

List Files Shared With Me (Deprecation Notice)

Returns all files shared with the current 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. | key: listSharedFiles

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Fetch All	When true, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Pagination	Page-size and page-token controls for paging through results.

Example Payload for List Files Shared With Me (Deprecation Notice)⤓

Loading…

List Groups

Returns a list of all groups the user has access to. | key: listGroups

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Fetch All	When true, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Pagination	Page-size and page-token controls for paging through results.

Example Payload for List Groups⤓

Loading…

List Items In Directory

Returns a list of all items in the given directory. | key: listDriveItems

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Directory	The directory path of the file. Use a forward slash (/) to access the root directory.	/myFolder/examples
Fetch All	When true, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Pagination	Page-size and page-token controls for paging through results.

Example Payload for List Items In Directory⤓

Loading…

List My Drives

Returns a list of all drives available to the current user. | key: listDrives

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Fetch All	When true, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Pagination	Page-size and page-token controls for paging through results.

Example Payload for List My Drives⤓

Loading…

List Shared

Lists shared items in SharePoint or OneDrive. | key: listShared

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.

Example Payload for List Shared⤓

Loading…

List Sites

Returns a list of all sites available to the current user. | key: listSites

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Fetch All	When true, automatically fetches all pages of results by following @odata.nextLink. Page Limit and Page Token inputs are ignored when this is enabled.	false
Pagination	Page-size and page-token controls for paging through results.

Example Payload for List Sites⤓

Loading…

List Subscriptions

Lists all available subscriptions. | key: listSubscriptions

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

Example Payload for List Subscriptions⤓

Loading…

Move File

Moves the given file to a new location. | key: moveFile

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Current Location	Provide a leading slash, followed by the location and name of the file	/myFile.txt
New File Name	The new name for the file.	myNewFile.txt
New Location	Provide a leading slash, followed by the new location of the file.	/myfiles/myfile.txt

Example Payload for Move File⤓

Loading…

Raw Request

Sends a raw HTTP request to Microsoft OneDrive. | key: rawRequest

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Data	The HTTP body payload to send to the URL.	{"exampleKey": "Example Data"}
File Data	File Data to be sent as a multipart form upload.	[{key: "example.txt", value: "My File Contents"}]
File Data File Names	File names to apply to the file data inputs. Keys must match the file data keys above.
Form Data	The Form Data to be sent as a multipart form upload.	[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header	A list of headers to send with the request.	User-Agent: curl/7.64.1
Max Retry Count	The maximum number of retries to attempt. Specify 0 for no retries.	0
Method	The HTTP method to use.
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.
Response Type	The type of data you expect in the response. You can request json, text, or binary data.	json
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
Retry Delay (ms)	The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.	0
Timeout	The maximum time that a client will await a response to its request	2000
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.	/me/drive
Use Exponential Backoff	Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.	false

Example Payload for Raw Request⤓

Loading…

Renew Subscription

Extends the expiration date of an existing OneDrive subscription. | key: renewSubscription

Input	Notes	Example
Expiration Days	Number of days to extend the subscription (1-30). Renewals are capped at the Microsoft Graph maximum for drive resources, just under 30 days.	3
Connection	The Microsoft OneDrive connection to use.
Subscription ID	The unique identifier of the subscription.	48bf81d7-2d37-40a9-b47b-c1d1960d00f87

Example Payload for Renew Subscription⤓

Loading…

Search Drive

Searches the current drive for a string of text. | key: searchDrive

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
Search	The text to search for within the current drive.	myFile

Example Payload for Search Drive⤓

Loading…

Search Users

Finds the information and metadata of an existing user. | key: searchUser

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
User ID or Email	The unique identifier or email address of the user.	87d349ed-44d7-43e1-9a83-5f2406dee5bd

Example Payload for Search Users⤓

Loading…

Update File

Updates the information and metadata of a given file. | key: updateFile

Input	Notes	Example
Connection	The Microsoft OneDrive connection to use.
File Location	Provide a leading slash, followed by the location and name of the file.	/folder1/myFile.txt
New File Name	The new name for the file.	exampleFile.txt
New File Path	The path to the desired SharePoint resource. The root directory does not need to be included.	/myfiles/myfile.txt
Optional Values	Optional key-value pairs to include in the request body.	{"description": "Updated quarterly report"}

Example Payload for Update File⤓

Loading…

Upload File

Uploads a file to the connected drive. | key: uploadFile

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

Example Payload for Upload File⤓

Loading…

Changelog

2026-11-13

Updated the Drive Subscription trigger to keep its Microsoft Graph subscription active, and improved action and data source configuration:

Fixed the Drive Subscription trigger no longer receiving notifications after its Microsoft Graph subscription expired; the trigger now accepts a schedule and renews the subscription on each scheduled run through a new Scheduled Renewal branch, to just under the Microsoft Graph maximum for drive resources
Added a Lifecycle Event branch to the Drive Subscription trigger that handles Microsoft Graph lifecycle notifications, renewing the subscription when Graph asks for reauthorization and recreating it when Graph removes it
Updated the Drive Subscription trigger to allow its subscription requests more time to complete
Fixed the Renew Subscription action extending a subscription by the entered number of minutes instead of days
Updated the Update File action to resolve the new parent folder path under the drive root, matching Move File
Added the Select Sites, Select Drives from Sites, and Select Folders from Drives data sources for selecting several sites, drives, and top-level folders in the configuration wizard; each takes one or more parents (a single ID, a list of IDs, or the selection from the previous data source), skips a site or drive that Microsoft Graph refuses or no longer has when several are selected instead of failing the whole list, and Select Folders from Drives keys combine the drive ID and folder ID, separated by a colon
Fixed the Item ID dropdown on the Delete File, Get Item, and List Children actions showing no options; it now lists the top-level files and folders of the selected Drive ID through a new Select Drive Item data source
Fixed the List Folders from Source data source failing when Directory is a folder path such as /Reports/2024; it now lists that folder
Fixed the Select Site, List Drives from Source, List Groups from Source, and List Users from Source data sources returning only the first page of results; they now return every page, and Select Site now lists sites under the OAuth 2.0 connection, where it previously returned none
Updated the List Drives from Source, List Groups from Source, List Users from Source, and Select Site data sources to return their options in the picklist result format
Updated the Files in Directory data source label to List Files in Directory
Updated the OAuth 2.0 connection to show the Scopes field
Updated the List My Drives, List Drives By User, List Drives By Group, List Drives By Site, List Groups, List Sites, List Children, List Items In Directory, and List Files Shared With Me (Deprecation Notice) actions to group Page Limit and Page Token into Pagination; Fetch All stays a top-level toggle
Updated the List Changes action to group its query options into Query Parameters
Added inline action calling support to 27 actions for improved example output during configuration
Added output schemas to 24 actions for improved field mapping during configuration

2026-11-11

Refactored internal code

2026-11-10

Published the component as an npm package, so code-native integrations can install it and call its actions, triggers and data sources from code with TypeScript types

2026-11-09

Updated file handling ahead of Microsoft's pre-authenticated URL deprecation and standardized the subscription action labels:

Updated the Download File action to use the official Microsoft Graph /content endpoint instead of the deprecated @microsoft.graph.downloadUrl property
Updated the Files in Directory data source to return item IDs instead of download URLs as the selected value
Updated the Create a Subscription and Delete a Subscription action labels to Create Subscription and Delete Subscription; action keys are unchanged, so existing steps keep working

2026-11-06

Updated spectral to 10.38.5 and switched the build from webpack to tsdown:

tsdown 0.22.3

2026-07-27

Updated the Fetch All option on list actions so results are returned in the same { value: [ ... ] } shape as a single page call; previously enabling Fetch All returned a bare array, so integrations that read the value property received no items

2026-06-26

Notice of Deprecation the List Files Shared With Me action; its underlying Microsoft Graph endpoint is degraded and scheduled for removal around November 2026, so use the List Shared action instead. Added a deprecation notice to the action description
Updated the List Subscriptions action so the Show Instance Subscriptions toggle is honored; previously it always filtered to instance subscriptions regardless of the setting
Updated the Update File action so it no longer sends empty name or path values when those optional inputs are left blank, preventing unintended clearing of existing values

2026-06-11

Added Fetch All toggle to list actions (List My Drives, List Drives By User, List Drives By Group, List Drives By Site, List Sites, List Groups, List Children, List Items In Directory, List Files Shared With Me) that automatically follows @odata.nextLink pagination to retrieve all pages of results in a single call; when disabled, existing single-page behavior with Page Limit and Page Token inputs is preserved

2026-04-30

Updated spectral version

2026-04-07

Added global debug support across all actions for improved troubleshooting

2026-03-05

Added inline data source for subscriptions to enable dynamic dropdown selection

2026-02-26

Added inline data source for sites to enable dynamic dropdown selection

2025-12-09

Enhanced webhook lifecycle management with automatic subscription handling:

Added Drive Subscription trigger with automatic subscription creation on instance deploy and deletion on instance removal
Added Renew Subscription action for extending subscription expiration dates

Microsoft OneDrive Connector

Description​

API Documentation​

Connections​

OAuth 2.0​

Prerequisites​

Setup Steps​

Configure the Connection​

App Verification and Admin Consent​

Publisher Verification​

Admin Consent​

Triggers​

Drive Subscription​

How It Works​

Configuration​

Event Types​

Branches​

Returned Data​

Best Practices​

Notes​

Webhook​

How It Works​

Configuration​

Event Types​

Branches​

Returned Data​

Best Practices​

Notes​

Data Sources​

List Drives from Source​

List Files in Directory​

List Folders from Source​

List Groups from Source​

List Users from Source​

Select Drive Item​

Select Drives from Sites​

Select Folders from Drives​

Select Site​

Select Sites​

Select Subscription​

Actions​

Create Subscription​

Delete All Instanced Subscriptions​

Delete File​

Delete Subscription​

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​

Changelog​

2026-11-13​

2026-11-11​

2026-11-10​

2026-11-09​

2026-11-06​

2026-07-27​

2026-06-26​

2026-06-11​

2026-04-30​

2026-04-07​

Description

API Documentation

Connections

OAuth 2.0

Prerequisites

Setup Steps

Configure the Connection

App Verification and Admin Consent

Publisher Verification

Admin Consent

Triggers

Drive Subscription

How It Works

Configuration

Event Types

Branches

Returned Data

Best Practices

Notes

Webhook

How It Works

Configuration

Event Types

Branches

Returned Data

Best Practices

Notes

Data Sources

List Drives from Source

List Files in Directory

List Folders from Source

List Groups from Source

List Users from Source

Select Drive Item

Select Drives from Sites

Select Folders from Drives

Select Site

Select Sites

Select Subscription

Actions

Create Subscription

Delete All Instanced Subscriptions

Delete File

Delete Subscription

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

Changelog

2026-11-13

2026-11-11

2026-11-10

2026-11-09

2026-11-06

2026-07-27

2026-06-26

2026-06-11

2026-04-30

2026-04-07

2026-03-05