Overview
Microsoft 365 SharePoint is a cloud-based collaboration and content management platform used by organizations to store documents, manage files, create intranet sites, and facilitate team collaboration. SharePoint is commonly used by operations teams, IT departments, project teams, and enterprise organizations to manage structured and unstructured content.
The Microsoft 365 SharePoint integration within the Wrk platform allows you to automate document management, list management, file retrieval, folder operations, and other SharePoint workflows through prebuilt Wrk Actions that interact with Microsoft Graph and SharePoint APIs.
This document provides an overview of how Microsoft 365 SharePoint integrates into Wrk, how authentication works, general API behaviour, and a full list of available Wrk Actions.
Authentication
Microsoft SharePoint uses OAuth 2.0 authentication for secure access.
Create a new Microsoft SharePoint Connected Account in Wrk.
Sign in using your Microsoft 365 account.
Review and approve the requested permissions.
Select the SharePoint account or tenant Wrk should access.
Important Notes
Access tokens expire automatically and are refreshed by Wrk in the background.
Revoking permissions in Microsoft Entra ID or Microsoft 365 requires the account to be reauthenticated.
Organization-level conditional access policies may block authentication depending on tenant configuration.
General API Behaviour
SharePoint Resource Structure
The Microsoft 365 SharePoint integration uses the Microsoft Graph REST API.
Most SharePoint content is represented through resources such as Sites, Drives (Document Libraries), Lists, List Items, and DriveItems. Files and folders stored within document libraries are typically returned as DriveItem objects.
Common properties returned by SharePoint resources include:
id — unique identifier for the resource
name — file, folder, list, or site name
parentReference — metadata about the parent location
webUrl — browser-accessible URL for the resource
createdDateTime — creation timestamp
lastModifiedDateTime — last modification timestamp
Many Wrk Actions require one or more identifiers, such as a Site ID, Drive ID, List ID, or Item ID. These identifiers are returned by retrieval operations and should be passed into subsequent actions exactly as returned by the API.
Pagination
Many SharePoint and Microsoft Graph endpoints return paginated results when large datasets are requested. Responses may include an @odata.nextLink property indicating additional pages are available.
Example:
{ "@odata.nextLink": "https://graph.microsoft.com/..." }When present, additional requests should be made using the supplied nextLink value until all records have been retrieved.
Filtering
Many SharePoint resources support filtering using OData query parameters.
Examples include:
$filter=startswith(name,'Project')
$filter=createdDateTime ge 2025-01-01T00:00:00Z
Filtering allows workflows to retrieve only relevant records and reduce payload size.
Field Selection
Microsoft Graph supports selective field retrieval using the Select properties $select input.
$select=id,name,createdDateTime
Using field selection improves performance by returning only required properties.
Sorting
Many list and collection endpoints support sorting through the $orderby parameter.
Example:
$orderby=name asc
$orderby=lastModifiedDateTime desc
Sorting is particularly useful when working with large document libraries or SharePoint lists.
Available Wrk Actions for Microsoft 365 SharePoint
Copy folder or file in Microsoft 365 SharePoint
Create a new list item in Microsoft 365 SharePoint
Create folder in Microsoft 365 SharePoint
Delete a list item in Microsoft 365 SharePoint
Delete folder or file in Microsoft 365 SharePoint
Follow folder or file in Microsoft 365 SharePoint
Retrieve available drives from Microsoft 365 SharePoint
Retrieve contents of a folder from Microsoft 365 SharePoint
Retrieve default site from Microsoft 365 SharePoint
Retrieve followed folders and files from Microsoft 365 SharePoint
Retrieve folder or file from Microsoft 365 SharePoint
Retrieve list activities from Microsoft 365 SharePoint
Retrieve list item activities from Microsoft 365 SharePoint
Retrieve list item from Microsoft 365 SharePoint
Retrieve list items from Microsoft 365 SharePoint
Retrieve lists from Microsoft 365 SharePoint
Retrieve root folder contents from Microsoft 365 SharePoint
Retrieve site drive from Microsoft 365 SharePoint
Search drive in Microsoft 365 SharePoint
Update folder or file in Microsoft 365 SharePoint
Update list item fields in Microsoft 365 SharePoint
Update list item in Microsoft 365 SharePoint
Additional Resources
Microsoft Graph API Documentation
SharePoint REST API Documentation
Microsoft Graph Authentication
Microsoft Graph Query Parameters
Microsoft Graph Paging
Microsoft Graph Throttling Guidance
SharePoint Limits and Boundaries