Skip to main content

Microsoft 365 SharePoint — Application Overview

Overview​

Microsoft SharePoint is a content management and collaboration platform in the Microsoft 365 ecosystem. Teams use it to store documents, manage sites and document libraries, and maintain structured lists.

The Microsoft 365 SharePoint integration within the Wrk platform lets you automate site, list, and drive workflows by calling the Microsoft Graph SharePoint / OneDrive-for-Business APIs through prebuilt Wrk Actions.

This document provides an overview of how SharePoint integrates into Wrk, how authentication works, general API behaviour, and a list of available Wrk Actions.

Authentication​

Microsoft 365 SharePoint uses OAuth 2.0 authentication for secure access.

  1. Create a new Microsoft 365 SharePoint Connected Account in Wrk.
  2. Sign in using your Microsoft 365 account.
  3. Review and approve the requested permissions.
  4. Complete the authorization flow so Wrk can access the SharePoint sites and drives you need.

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.
  • Actions are limited to sites, lists, and drives the Connected Account is allowed to access.

General API Behaviour​

Microsoft Graph sites, lists, and drives​

The SharePoint integration uses the Microsoft Graph REST API.

Common resource types include:

  • Site — a SharePoint site
  • List / ListItem — structured list data and rows
  • Drive / DriveItem — document libraries, folders, and files

Drive items typically include identifiers such as id, name, parentReference, and webUrl. List items are addressed with site, list, and item IDs.

Pagination​

Large collection responses are paginated. Microsoft Graph returns an @odata.nextLink when more pages are available; use that URL for subsequent requests.

Query parameters​

Microsoft Graph supports OData query parameters such as $select, $filter, $top, $orderby, and $expand.

Available Wrk Actions​

  • Copy folder or file
  • Create a new item in a list
  • Create folder
  • Delete a list item
  • Delete folder or file
  • Follow folder or file
  • Perform an API call
  • Retrieve a list item in a list
  • Retrieve available drives
  • Retrieve contents of a folder
  • Retrieve default site
  • Retrieve folder or file
  • Retrieve followed folders and files
  • Retrieve list activities
  • Retrieve list item activities
  • Retrieve list items
  • Retrieve lists
  • Retrieve root folder contents
  • Retrieve site drive
  • Search drive
  • Update folder or file
  • Update list item
  • Update list item fields

Additional Resources​