OneDrive is Microsoft’s cloud storage and file synchronization service that allows users to securely store, access, and share files across devices. Integrated deeply into the Microsoft 365 ecosystem, OneDrive supports seamless collaboration, version control, and real-time access to content across teams and organizations.
Learn how to integrate the OneDrive tool in Sim to automatically pull, manage, and organize your cloud files within your workflows. This tutorial walks you through connecting OneDrive, setting up file access, and using stored content to power automation. Ideal for syncing essential documents and media with your agents in real time.
With OneDrive, you can:
- Store files securely in the cloud: Upload and access documents, images, and other files from any device
- Organize your content: Create structured folders and manage file versions with ease
- Collaborate in real time: Share files, edit them simultaneously with others, and track changes
- Access across devices: Use OneDrive from desktop, mobile, and web platforms
- Integrate with Microsoft 365: Work seamlessly with Word, Excel, PowerPoint, and Teams
- Control permissions: Share files and folders with custom access settings and expiration controls
In Sim, the OneDrive integration enables your agents to directly interact with your cloud storage. Agents can upload new files to specific folders, retrieve and read existing files, and list folder contents to dynamically organize and access information. This integration allows your agents to incorporate file operations into intelligent workflows — automating document intake, content analysis, and structured storage management. By connecting Sim with OneDrive, you empower your agents to manage and use cloud documents programmatically, eliminating manual steps and enhancing automation with secure, real-time file access.
Integrate OneDrive into the workflow. Can create text and Excel files, upload files, download files, list and search files, move or rename files, copy files, create sharing links, and delete files or folders.
Upload a file to OneDrive
| Parameter | Type | Required | Description |
|---|
fileName | string | Yes | The name of the file to upload (e.g., "report.pdf", "data.xlsx") |
file | file | No | The file to upload (binary) |
content | string | No | The text content to upload (if no file is provided) |
mimeType | string | No | The MIME type of the file to create (e.g., text/plain for .txt, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet for .xlsx) |
folderId | string | No | Folder ID to upload the file to (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M") |
| Parameter | Type | Description |
|---|
success | boolean | Whether the file was uploaded successfully |
file | object | The uploaded file object with metadata including id, name, webViewLink, webContentLink, and timestamps |
Create a new folder in OneDrive
| Parameter | Type | Required | Description |
|---|
folderName | string | Yes | Name of the folder to create (e.g., "My Documents", "Project Files") |
folderId | string | No | Parent folder ID to create the folder in (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M") |
| Parameter | Type | Description |
|---|
success | boolean | Whether the folder was created successfully |
file | object | The created folder object with metadata including id, name, webViewLink, and timestamps |
Download a file from OneDrive
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | The ID of the file to download (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M") |
fileName | string | No | Optional filename override (e.g., "report.pdf", "data.xlsx") |
| Parameter | Type | Description |
|---|
file | file | Downloaded file stored in execution files |
List files and folders in OneDrive
| Parameter | Type | Required | Description |
|---|
folderId | string | No | Folder ID to list files from (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M") |
query | string | No | Filter files by name prefix (e.g., "report", "invoice_2024") |
pageSize | number | No | Maximum number of files to return (e.g., 10, 50, 100) |
pageToken | string | No | Continuation URL from a previous response's nextPageToken, used to fetch the next page |
| Parameter | Type | Description |
|---|
success | boolean | Whether files were listed successfully |
files | array | Array of file and folder objects with metadata |
nextPageToken | string | Token for retrieving the next page of results (optional) |
Search for files and folders across OneDrive by name, metadata, or content (recursive)
| Parameter | Type | Required | Description |
|---|
query | string | No | Search text matched against file name, metadata, and content. Not required when paginating with pageToken |
pageSize | number | No | Maximum number of results to return (e.g., 10, 50, 100) |
pageToken | string | No | Continuation URL from a previous response's nextPageToken, used to fetch the next page |
| Parameter | Type | Description |
|---|
success | boolean | Whether the search completed successfully |
files | array | Array of file and folder objects matching the search query |
nextPageToken | string | Token for retrieving the next page of results (optional) |
Get metadata for a specific OneDrive file or folder by ID, or the drive root
| Parameter | Type | Required | Description |
|---|
fileId | string | No | The ID of the file or folder to retrieve (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M"). Leave empty to get the drive root folder |
| Parameter | Type | Description |
|---|
success | boolean | Whether the item metadata was retrieved |
file | object | The file or folder metadata, including id, name, webViewLink, size, and timestamps |
Get information about the OneDrive drive, including storage quota
| Parameter | Type | Required | Description |
|---|
| Parameter | Type | Description |
|---|
success | boolean | Whether the drive info was retrieved |
driveId | string | The ID of the drive |
driveType | string | The type of drive (e.g., "personal", "business") |
webUrl | string | URL to the drive in the browser |
owner | string | Display name of the drive owner |
quota | object | Storage quota information in bytes (total, used, remaining, deleted, state) |
Move a file or folder to a new parent folder, rename it, or both
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | The ID of the file or folder to move or rename |
destinationFolderId | string | No | The ID of the destination parent folder (omit to only rename in place) |
newName | string | No | The new name for the file or folder (omit to only move) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the move or rename was successful |
file | object | The updated file object with its new name and/or parent folder |
Copy a file or folder to another location within OneDrive
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | The ID of the file or folder to copy |
destinationFolderId | string | Yes | The ID of the destination parent folder |
destinationFileName | string | No | Optional new name for the copy (defaults to the original name) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the copy request was accepted |
sourceFileId | string | The ID of the file or folder that was copied |
name | string | The requested name for the copy, if provided |
monitorUrl | string | URL to poll for the status of the asynchronous copy operation (copy completes in the background) |
Create a view or edit sharing link for a OneDrive file or folder
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | The ID of the file or folder to share |
linkType | string | No | Type of link to create: "view" (read-only), "edit" (read-write), or "embed" |
linkScope | string | No | Who can use the link: "anonymous" (anyone), "organization" (tenant members), or "users" (specific people) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the sharing link was created successfully |
link | object | The created sharing link, including its type, scope, and URL |
Delete a file or folder from OneDrive
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | The ID of the file or folder to delete (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M") |
| Parameter | Type | Description |
|---|
success | boolean | Whether the file was deleted successfully |
deleted | boolean | Confirmation that the file was deleted |
fileId | string | The ID of the deleted file |