Skip to main content
Back to list of enterprise systems Use the Microsoft OneDrive integration to upload and download files, list files and folders, or call Microsoft Graph through Action Tools. It also provides a trigger for new files.

Supported actions

Triggers

Prerequisites

  • A Microsoft OneDrive account with access to the files and folders the tools will use.
  • A Microsoft Entra ID app registration and the permissions required by the selected actions and authentication mode.

Set up the integration

1

Register an app in Microsoft Entra ID

Register an app and configure Microsoft Graph permissions for the OneDrive operations the agent needs. For delegated access, add the callback URL shown in the Studio auth profile as a Web redirect URI. For app-only access, configure the required application permissions and grant tenant admin consent. Keep the application (client) ID, tenant ID, and client secret available for the profile.
2

Create the auth profile

In Integrations, select Microsoft OneDrive > Connect. On Project Auth Profiles, select New Profile > Integration Profile > Microsoft OneDrive > Continue. Choose an auth type, enter its configuration and secret values, and select Create Profile. For OAuth 2.0 App (User Delegated), select Authorize and complete Microsoft consent.Studio offers Azure AD (Service Principal), OAuth 2.0 App (User Delegated), and OAuth 2.0 Client Credentials. The service-principal and client-credentials profiles use admin-provided credentials. For delegated OAuth, the usage modes are Preconfigured, JIT (Just-in-Time), and Preflight.For delegated OAuth, Studio prepopulates the Microsoft authorization, token, and refresh endpoints. The inspected profile showed the scopes User.Read, Files.Read.All, and offline_access; the connector catalog lists Files.ReadWrite and offline_access as its defaults. Ensure the profile has the permissions required for the actions you select, including write permission for Upload file, and grant consent in Entra ID. The callback URL is environment-specific; use the value displayed in your profile.
3

Create the action tool

In Tools, select New Tool > Action > Microsoft OneDrive > Continue. Select the Action and Auth Profile, configure the inputs, and choose whether to return the complete connector response or define custom output parameters. Select Create Tool, then assign the tool to an agent.

Auth profile reference

The auth profile form includes a profile name and description. Visible to project members is enabled by default. Studio shows the following configuration by auth type: For delegated OAuth, Studio’s default additional authorization parameters are response_type=code and response_mode=query. Use the callback URL shown in the profile; its host varies by environment.

Action reference

The parameter details below match the action forms in Studio. Folder dropdowns can list up to 1,000 folders. The form notes that if a folder is missing, use the (F) option to enter its ID; OneDrive folder IDs appear after ?id= in the folder URL.

Trigger reference

The New File trigger has one optional folder selector. The form’s note explains that the folder picker lists up to 1,000 folders; use (F) to enter a folder ID if needed.

Troubleshoot common issues