Microsoft OneDrive Spoke
Automate file and folder management and collaboration in Microsoft OneDrive. Adds Microsoft OneDrive data to your ServiceNow instance.
Request apps on the Store
Visit the ServiceNow Store to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.
Integration Hub subscription
This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview.
Spoke version
Microsoft OneDrive spoke v2.9.0 is the latest version.
Spoke dependencies
If you’re having trouble installing the app, ensure that these dependent plugins are installed:
- ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
- ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
Note: Some of these plugins are licensable features and require an appropriate license if used outside the spoke implementation. For information on licenses, contact your account manager.
Supported versions
API version v1.
Spoke flows
The Microsoft OneDrive spoke gives sample flows in the draft state to demonstrate automating Microsoft OneDrive tasks. To customize a sample flow, copy it to a new application scope. Available sample flows include:
| Flow | Description |
|---|---|
| Renew Subscriptions | Renews the expired subscriptions by updating the expiration date of the subscription. |
Spoke subflows
The Microsoft OneDrive spoke provides sample subflows in the draft state to demonstrate automating Microsoft OneDrive tasks. To customize a sample subflow, copy it to a new application scope. Available sample subflows include:
| Subflow | Description |
|---|---|
| Download New OneDrive File to ServiceNow | Downloads the new files uploaded in a resource to a ServiceNow record |
| Subscribe to Webhook | Subscribes a listener application to receive notifications when data changes. |
| Sync Changes | Tracks changes to a drive and its children over time. |
| Get Document Latest URL | Gets the latest path of a file in OneDrive using the Sys ID of the document as an input. To use this subflow, a corresponding OneDrive connection and credential must be created, and a OneDrive authorization token should be available. |
| Reconnect Document from Microsoft OneDrive | Gets the latest web URL and webdav URL of a document from the Microsoft OneDrive by using the Document Sys ID, Provider Detail Sys ID, Target Table Name, Target Table Sys ID, and the Document Name. To use this subflow, a corresponding OneDrive connection and credential must be created, and a OneDrive authorization token must be available. |
Spoke actions
The Microsoft OneDrive spoke provides actions to automate Microsoft OneDrive tasks when events occur in ServiceNow. Available actions include:
| Category | Action | Description |
|---|---|---|
| Drive Management | Look up Drive Info | Gets the metadata of a specific Microsoft OneDrive drive |
| Folder Management | Move File Or Folder Item | Moves a file or folder in Microsoft OneDrive to the target location. |
| Create Folder | Creates a folder in Microsoft OneDrive. | |
| Update File Or Folder Name | Updates the name for a file or folder item by ID. | |
| Delete File Or Folder Item | Deletes a file or folder from Microsoft OneDrive. | |
| File Management | Check In File | Checks in a drive item and sends a sharing invitation. When you check in a file, other users can access the checked-in file. |
| Check Out File | Checks out a drive item from OneDrive. When you check out a drive item, other users cannot edit the document. Other users also cannot see the changes that you made in the document until you check in the document. | |
| Copy OneDrive File to Attachment | Copies a file in Microsoft OneDrive to an attachment in a record in a ServiceNow record. | |
| Copy Attachment to OneDrive | Copies an attachment record in ServiceNow to Microsoft OneDrive | |
| Copy File Or Folder Item | Asynchronously creates a copy of a Microsoft OneDrive item \(including children\), under a new parent item or with a new name. | |
| Look up Items | Retrieves a list of drive items from a path or the source and source ID of a drive item. | |
| Look up File Or Folder Item Info By ID | Gets file metadata information from the file or folder ID in Microsoft OneDrive. | |
| Look up File Or Folder Item Info By Path | Gets file metadata information from the file path in Microsoft OneDrive. | |
| Copy Attachment To OneDrive Using Path | Copies an attachment record in ServiceNow to OneDrive. | |
| Copy OneDrive File To Attachment Using File Path | Copies a file using its path in OneDrive to an attachment in a record in ServiceNow. | |
| Copy OneDrive File Version To Attachment | Copies a file in OneDrive to an attachment in a record in ServiceNow. | |
| Delete Version of a File | Deletes the specified version of a file from OneDrive. | |
| Look up All Versions of a File | Retrieves all the versions a file in OneDrive. | |
| Restore File Version | Restores the specified file version and make this version the latest. | |
| Upload and Replace File | Uploads the updated version of an existing file or replaces the existing file with a new file. Note: The maximum size of the file cannot exceed 4 MB. | |
| Search Documents | Search Files or Folder Items | Searches the drive items \(files or folders\) based on metadata attributes such as the item name. |
| Document Sharing | Add Collaborator | Adds a collaborator and their permissions to a file or a folder. You can identify the collaborator by their Azure AD Alias or an Object ID. |
| Look up Collaborators | Lists all the collaborator details associated with a file or folder in Microsoft OneDrive. | |
| Remove Collaborator | Removes a collaborator from a file or folder in Microsoft OneDrive. | |
| Permission Management | Add Permission | Sends a sharing invitation for a drive item. A sharing invitation allows the recipients to access the drive item and optionally sends them an email with a sharing link. |
| Create Sharing Link | Creates a sharing link which allows you to share a drive item with other users. | |
| Delete Permission | Removes access to a drive item. | |
| Look up Permissions | Retrieves the sharing permissions of a drive item. | |
| Update Permission | Updates the expiration date of the subscription. | |
| Webhook Management | Subscribe Webhook | Creates a subscription that sends notifications when data changes. |
| Unsubscribe Webhook | Deletes the specified subscription ID. | |
| Get SyncToken for Subscription | Retrieves the latest sync token for the specified subscription ID. | |
| Look up Subscriptions | Retrieves the list of active subscriptions. | |
| Renew Subscription | Updates the expiration date of the subscription. | |
| Sync Changes | Tracks changes to a drive and drive's children over time. |
Available AI agents
Install Now Assist for Integration Hub and start using the available AI agents. For more information, see ServiceNow Otto for Integration Hub.
This spoke provides standalone AI agents that mimic human-like intelligence to perform tasks in your ServiceNow instance.
In the ServiceNow agentic system, you can create an agentic workflow that comprises of a set of large language model (LLM) instructions along with one or more standalone AI agents to execute an objective. See for information about adding AI agents to create agentic workflows as per your requirement and provide the required trigger.
You can also search for other available AI agents and add them to your agentic workflow. See Find AI agents for more information.
You can create a clone of the required spoke AI agent and customize it as per your requirement. See for more information about creating a clone.
- See for information about AI agents.
Available AI agents include:
| AI Agent | Description |
|---|---|
| Microsoft OneDrive sharing management AI agent | Adds or removes a collaborator and manages their permissions for a file or folder in Microsoft OneDrive. Also, lists all the collaborator details associated with a file or folder. |
| Microsoft OneDrive drive management AI agent | Retrieves the metadata of a specific drive in Microsoft OneDrive. |
| Microsoft OneDrive file management AI agent | Manages files, file versions, and attachments in Microsoft OneDrive. Also, retrieves details of the required file. |
| Microsoft OneDrive folder management AI agent | Manages folders in Microsoft OneDrive. |
| Microsoft OneDrive permission management AI agent | Creates sharing link for a drive item and manages permissions. |
There might be AI agents installed with the Now Assist application that are not used in agentic workflows. To learn how to see all agents that are available to you, see Find AI agents.
Note: Ensure that the user running an AI agent has the required roles and permissions to access data or perform operations on data in the table that is associated with the AI agent.
Spoke module
Bi-directional webhooks can be set up to get notifications about the required events. Routing policy defines conditions that must be met to notify the ServiceNow app. These conditions are based on the events in OneDrive that you want to be notified about. When the conditions are met, a routing policy triggers the associated subflow, which in turn automates the OneDrive tasks.
The bi-directional webhooks require separate setup and can be used independently without using the spoke actions. By default, the OneDrive Webhooks application is available in the OneDrive spoke and has the following modules:
| Module | Description |
|---|---|
| OneDrive SyncToken | Enables you to view SyncTokens of OneDrive. |
| OneDrive Webhook Registries | Enables you to create and view the OneDrive webhooks in ServiceNow. |
| OneDrive Webhook Routing Policy | Enables you to create and view the routing policies for the OneDrive webhooks in ServiceNow. You can also customize the conditions in the routing policies as per your requirement. |
OneDrive Online account requirements
The Microsoft OneDrive spoke requires a custom app that you create in Microsoft Azure.
Connection and credential alias requirements
Integration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.
Single tenant
The OneDrive spoke includes the OneDrive alias record to authorize actions on Microsoft OneDrive. Select this alias in the Tenant record to authorize changes in Microsoft OneDrive for a single tenant.
For information about setting up the spoke, see Set up Microsoft OneDrive spoke.
MID Server requirements
These actions use REST calls that can run either on an instance or, optionally, through a MID Server. Use the connection record associated with the Microsoft OneDrive alias to configure where actions run and, if needed, specify MID Server selection attributes. For more information, see MID server.
To set up the MID Server for this spoke, see Set up MID Server for a spoke.