Connects to Microsoft Graph SharePoint resources so workflows can read and manage sites, lists, document libraries, and files.
Revision details were not found in a dedicated help history source in this repository.
- 0.0.0.10 - 2026/04/20 - Added deterministic non-recursive file download behavior.
- 0.0.0.11 - 2026/04/20 - Added create-folder and upload-file support.
- 0.0.0.12 - 2026/04/21 - Updated project package/build metadata.
- 0.0.0.13 - 2026/04/22 - Added support for populating list items.
- 0.0.0.14 - 2026/04/22 - Refined helper structure and connection/auth handling.
- 0.0.0.15 - 2026/04/22 - Improved Graph error parsing and debug-gated tenant-dependent diagnostics.
- 0.0.0.16 - 2026/04/22 - Reused delegated access tokens until expiry and moved token provider into its own file.
The connection stores Microsoft Entra OAuth settings and optional default SharePoint targeting values used by methods when site or drive inputs are omitted.
| Property |
Type |
Description |
Tenant ID |
String |
Microsoft Entra tenant identifier for the app registration. |
Client ID |
String |
Microsoft Entra application (client) ID. |
Client Secret |
Masked String |
Microsoft Entra application secret used for token acquisition and refresh. |
SharePoint Hostname |
String |
Optional hostname hint (for example contoso.sharepoint.com) used when resolving sites by relative path. |
Default Site Path |
String |
Optional default site path (for example /sites/Finance) used by templates and method calls when no explicit site is supplied. |
Default Document Library |
String |
Optional default document library name used when no explicit drive identifier is supplied. |
Scopes |
String |
Delegated OAuth scopes used for authorization and refresh (default includes Sites.ReadWrite.All). |
Access Token |
Masked String |
Delegated OAuth access token. |
Refresh Token |
Masked String |
Delegated OAuth refresh token. |
- Configure an Azure/Microsoft Entra app registration with delegated permissions for SharePoint Graph operations.
- The node validates
Tenant ID, Client ID, and Client Secret; these are required.
- Delegated token refresh requires runtime-provided connection lock/update delegates; without them, token refresh fails.
- Delegated access tokens are reused until close to expiry, then refreshed through connection lock/update delegates.
- Connection test performs token acquisition and then calls Graph to verify access.
The node exposes methods for site resolution, list and list item operations, and document library file/folder operations.
Gets a SharePoint site by Graph site ID, absolute site URL, or relative site path.
| Parameter |
Type |
Description |
Connection |
Connection |
SharePoint connection details including auth and defaults. |
SiteID |
String |
Graph site identifier. Optional when SiteURL or SitePath is supplied. |
SiteURL |
String |
Absolute SharePoint site URL. |
SitePath |
String |
Relative site path (for example /sites/Finance). |
| Return |
Type |
Description |
Site |
Object |
Microsoft Graph site payload. |
Lists SharePoint lists in the selected site.
| Parameter |
Type |
Description |
Connection |
Connection |
SharePoint connection details including auth and defaults. |
SiteID |
String |
Graph site identifier. Optional when SiteURL or SitePath is supplied. |
SiteURL |
String |
Absolute SharePoint site URL. |
SitePath |
String |
Relative site path. |
| Return |
Type |
Description |
Lists |
Array |
List entries for the resolved site. |
Lists items from a SharePoint list and returns normalized item rows.
| Parameter |
Type |
Description |
Connection |
Connection |
SharePoint connection details including auth and defaults. |
ListID |
String |
Graph list identifier. Optional when ListName is supplied. |
ListName |
String |
Display name of the list. |
SiteID |
String |
Graph site identifier. Optional when SiteURL or SitePath is supplied. |
SiteURL |
String |
Absolute SharePoint site URL. |
SitePath |
String |
Relative site path. |
| Return |
Type |
Description |
ListItems |
Array |
Normalized list items including fields, data, and raw payloads. |
Creates a SharePoint list in the resolved site using a selected Graph list template.
| Parameter |
Type |
Description |
Connection |
Connection |
SharePoint connection details including auth and defaults. |
ListName |
String |
Display name for the new list. |
Template |
String |
Graph list template (for example genericList or documentLibrary). |
SiteID |
String |
Graph site identifier. Optional when SiteURL or SitePath is supplied. |
SiteURL |
String |
Absolute SharePoint site URL. |
SitePath |
String |
Relative site path. |
| Return |
Type |
Description |
List |
Object |
Success/error response wrapper containing created list data or error details. |
Creates a SharePoint list item using field values keyed by SharePoint internal column names.
| Parameter |
Type |
Description |
Connection |
Connection |
SharePoint connection details including auth and defaults. |
Fields |
Object |
Field values keyed by internal SharePoint column names. |
ListID |
String |
Graph list identifier. Optional when ListName is supplied. |
ListName |
String |
Display name of the list. |
SiteID |
String |
Graph site identifier. Optional when SiteURL or SitePath is supplied. |
SiteURL |
String |
Absolute SharePoint site URL. |
SitePath |
String |
Relative site path. |
| Return |
Type |
Description |
ListItem |
Object |
Success/error response wrapper containing created item data or error details. |
Lists document libraries (drives) for the resolved site.
| Parameter |
Type |
Description |
Connection |
Connection |
SharePoint connection details including auth and defaults. |
SiteID |
String |
Graph site identifier. Optional when SiteURL or SitePath is supplied. |
SiteURL |
String |
Absolute SharePoint site URL. |
SitePath |
String |
Relative site path. |
| Return |
Type |
Description |
Drives |
Array |
Normalized drive rows for the selected site. |
Lists files and folders in a document library root or an optional parent folder.
| Parameter |
Type |
Description |
Connection |
Connection |
SharePoint connection details including auth and defaults. |
DriveID |
String |
Graph drive identifier. Optional when DriveName is supplied. |
DriveName |
String |
Document library name. |
ParentItemID |
String |
Optional parent folder item ID. Root is used when omitted. |
SiteID |
String |
Graph site identifier. Optional when SiteURL or SitePath is supplied. |
SiteURL |
String |
Absolute SharePoint site URL. |
SitePath |
String |
Relative site path. |
| Return |
Type |
Description |
DriveItems |
Array |
Normalized file/folder rows including file/folder flags and raw payload. |
Downloads file content from a document library item.
| Parameter |
Type |
Description |
Connection |
Connection |
SharePoint connection details including auth and defaults. |
ItemID |
String |
Drive item ID. Optional when ItemName is supplied. |
ItemName |
String |
File name resolved within ParentItemID or drive root. |
DriveID |
String |
Graph drive identifier. Optional when DriveName is supplied. |
DriveName |
String |
Document library name. |
ParentItemID |
String |
Optional parent folder item ID for name-based resolution. |
SiteID |
String |
Graph site identifier. Optional when SiteURL or SitePath is supplied. |
SiteURL |
String |
Absolute SharePoint site URL. |
SitePath |
String |
Relative site path. |
| Return |
Type |
Description |
File |
Stream |
Binary file content stream. |
Creates a folder in a document library at root or under an optional parent folder.
| Parameter |
Type |
Description |
Connection |
Connection |
SharePoint connection details including auth and defaults. |
FolderName |
String |
Folder name to create. |
DriveID |
String |
Graph drive identifier. Optional when DriveName is supplied. |
DriveName |
String |
Document library name. |
ParentItemID |
String |
Optional parent folder item ID. Root is used when omitted. |
SiteID |
String |
Graph site identifier. Optional when SiteURL or SitePath is supplied. |
SiteURL |
String |
Absolute SharePoint site URL. |
SitePath |
String |
Relative site path. |
| Return |
Type |
Description |
Folder |
Object |
Success/error response wrapper containing created folder data or error details. |
Uploads a file stream into a document library at root or under an optional parent folder.
| Parameter |
Type |
Description |
Connection |
Connection |
SharePoint connection details including auth and defaults. |
File |
Stream |
Binary content stream to upload. |
FileName |
String |
Name for the uploaded file. |
DriveID |
String |
Graph drive identifier. Optional when DriveName is supplied. |
DriveName |
String |
Document library name. |
ParentItemID |
String |
Optional parent folder item ID. Root is used when omitted. |
SiteID |
String |
Graph site identifier. Optional when SiteURL or SitePath is supplied. |
SiteURL |
String |
Absolute SharePoint site URL. |
SitePath |
String |
Relative site path. |
| Return |
Type |
Description |
DriveItem |
Object |
Success/error response wrapper containing uploaded item data or error details. |
- Site targeting can come from explicit method inputs (
SiteID, SiteURL, or SitePath) or connection defaults.
- Drive targeting can come from explicit
DriveID/DriveName or the connection’s default document library.
- Collection methods follow Microsoft Graph paging (
@odata.nextLink) and aggregate results before returning them.
- Name-based file resolution in
DownloadFile is intentionally non-recursive and only searches the selected parent scope (or root).
- The node provides templates for each method to speed up common operation setup.