Microsoft OneDrive
The OneDrive connector lets you connect to Microsoft OneDrive cloud storage in Designer. OneDrive is available as a data source in the Input Data and Output Data tools.
Upgrade to the New OneDrive Connector
If your workflow uses the standalone OneDrive Input or OneDrive Output tools, those are now deprecated. Instead, use connector version 2.2.0 or later with the Input Data and Output Data tools. Use the workflow migration utility to update existing workflows.
Requirements
Requirement | Details |
|---|---|
Designer | Designer 2026.1 or later. Designer 2025.2 Patch 3 or later. Designer 2025.1 Patch 5 or later. |
Connector Version | Microsoft OneDrive version 2.2.0 or later. Available from Designer Add-Ons. |
Azure Permissions | |
You must enable DCM in Designer. Go to Options >Advanced Settings > DCM to enable it. | |
Network Access | Outbound access to OneDrive Online and Microsoft OAuth endpoints. |
Install the Connector
Install the latest version of OneDrive connector directly from Designer using Add-Ons. This is the recommended installation method that allows you to browse, install, and update connectors without leaving Designer or visiting the Alteryx Marketplace.
To install the connector...
In Designer, go to Add-Ons > Manage Marketplace Add-Ons. You will see a list of available connectors.
Select Microsoft OneDrive Connector and select Install. Designer downloads and installs the package. Designer might require a restart to complete the installation.
After installation and setup are complete, the OneDrive connector is available from the Input Data and Output Data tools.
Set Up a Connection
To connect to Microsoft OneDrive...
Drag the Input Data or Output Data tool to the canvas, and select Connect to Data.
In the Connector Setup, select Create or Browse a Data Connection.
If you've created a Microsoft OneDrive connection before, you can select the connection from the Recents tab.
Select + New. From the list of technologies, select Microsoft OneDrive.
Enter the Connection Name and Data Source Name.
In the Credentials section, select your authentication method, and enter the credentials. For more information, see Authentication Methods.
Select Save. You can also test the connection before saving.
Select Connect. Microsoft OneDrive may request authentication.
Select the read or write configuration in the Options window. To know more about the options, see Read Data from OneDrive or Write Data to OneDrive.
Select Confirm to create a connection to the file. You can continue building your workflow.
Workflow Migration
If your existing workflows use the deprecated OneDrive Input or OneDrive Output tools, you need to migrate them to use the new connector. Use the workflow migration utility to update existing workflows.
The utility previews all the changes and replaces deprecated tool instances with the new connector versions without breaking the workflows.
Authentication Methods
Microsoft OneDrive supports three authentication methods. Use the table below to choose the right one for your use case.
Method | Details |
|---|---|
Azure AD-private (Built-In App) |
|
Azure AD-private (Custom App) |
|
Service Principal (Application) |
|
Limitations
The Microsoft OneDrive connector currently has the following limitations:
Microsoft's underlying Recent and Shared with Me Graph APIs are deprecated and do not return data. This is a platform-level limitation independent of this connector.
Partitioning is not supported.
Reading data with wildcards or from multiple files or folders is not supported, but it can be achieved using macros.
The output action Append is not supported. Use Read > Union > Overwrite to replicate append behavior.
When creating a new file, if a file with the same name already exists at the destination, the action will not overwrite it. Instead, it will append a timestamp suffix to the new file's name, retaining both files.
Reading multi-sheet XLSX files or selecting a sheet by name or index is not supported.
Path scoping is limited to My Files. Recent and Shared with Me are not browsable/ accessible through OneDrive.
Version | Beschreibung |
v3.1.1 |
|
v3.1.0 |
|
v2.3.0 |
|
v2.2.0 |
|
v2.1.0 |
|
v2.0.2 |
|
v2.0.1 |
|
v2.0.0 |
|
v1.0.2 |
|
v1.0.1 |
|
v1.0.0 |
|
Alteryx-Tools für die Verbindung
AMP Engine aktivieren
Die AMP Engine muss für Workflows aktiviert sein, die OneDrive-Tools ab Version 2.2.0 enthalten.
Benutzerdefinierte Microsoft Azure API-Anwendung einrichten
Informationen zum Einrichten einer benutzerdefinierten API-Anwendung für dieses Tool finden Sie in unserem Handbuch.

