With the following Public Integrations, you can upload, download, organize, and share files in Microsoft OneDrive:
- com.globant.geai.onedrive_upload_file: Uploads a file to OneDrive by streaming it from a source URL. Supports files up to 250 GB, with automatic chunked uploads for files larger than 4 MB. You can specify conflict behavior (rename, replace, or fail) when a file with the same name already exists.
- com.globant.geai.onedrive_download_file: Downloads a file from OneDrive at the specified path. Returns the file content as a Base64-encoded string together with file metadata.
- com.globant.geai.onedrive_read_file: Reads a file from OneDrive as text. Office files (.docx, .pdf, .pptx, .xlsx) are parsed and returned as extracted text or CSV. Other file types are returned as decoded text when possible.
- com.globant.geai.onedrive_list_items: Lists all files and folders in a specified OneDrive folder path. Returns each item's ID, name, type (file or folder), size, and web URL. If no folder path is provided, lists items from the root folder.
- com.globant.geai.onedrive_create_folder: Creates a new folder in OneDrive at the specified parent path. If a folder with the same name already exists, it is automatically renamed. If no parent path is provided, the folder is created in the root directory.
- com.globant.geai.onedrive_share_item: Generates a sharing link for a file or folder in OneDrive. Supports view (read-only) and edit (read-write) sharing types, with an optional expiration date.
- com.globant.geai.onedrive_delete_item: Deletes a file or folder from OneDrive at the specified path. The item is moved to the recycle bin if available.
When you add any of these Tools to an Agent, consumers will be prompted to complete the Microsoft OAuth 2.0 authorization. Login occurs interactively during the conversation with the Agent and authorizes the operation on behalf of the logged-in user.
Before using these Tools, you must register your Microsoft credentials as a Secret in your Project.
- In Console, open the Project where you will use this Integration and create two new Secrets. For instructions, see How to create a Secret.
- Create one Secret for the Client ID:
- Name: Enter a descriptive name (for example, onedrive_client_id).
- Value: Paste the Application (client) ID obtained from your Microsoft app registration in Microsoft Entra ID (Azure AD). This value identifies the registered application.
- Confirm to save the Secret.
- Create another Secret for the Client Secret:
- Name: Enter a descriptive name (for example, onedrive_client_secret).
- Value: Paste the Client Secret value generated in the same Microsoft app registration under Certificates & secrets.
- Confirm to save the Secret.
- In the Integrations Dashboard (Build > Integrations in Agentic Hub), open OneDrive (Microsoft) and go to the Integration Parameters tab. Configure the following values:
- securityScheme.authLevel: Set to User.
- securityScheme.flows.authorizationCode.clientId: Enter the name of the Secret created for the Client ID (for example, onedrive_client_id).
- securityScheme.flows.authorizationCode.clientSecret: Enter the name of the Secret created for the Client Secret (for example, onedrive_client_secret).
- securityScheme.flows.authorizationCode.scopes:
openid profile offline_access Files.ReadWrite
- These are the basic scopes required for authentication.
- You can add additional scopes depending on the permissions required by your application in Microsoft Graph.
- Optionally, configure the following parameters to use a specific Microsoft account directory instead of the default multi-tenant endpoint. Replace <tenant-id> with either the Directory (tenant) ID from your app registration in Microsoft Entra ID, or your tenant domain (for example, contoso.onmicrosoft.com):
- securityScheme.flows.authorizationCode.authorizationUrl:
https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize
- securityScheme.flows.authorizationCode.tokenUrl:
https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token
After completing these steps, you can add any of these Tools to an Agent from the AI & Tools Tab in the Agents Dashboard (Build > Agents in Agentic Hub).
Since version 2026-04.