SharePoint - Get Item

What it does

Get current metadata for a SharePoint file or folder when you already have its DriveItem ID.

Use this action when an earlier workflow step already returned an Item ID. If you know the library-relative path instead, use Get Item By Path.

When to use it

Refresh metadata for an item returned by an earlier action.
Retrieve the current name, type, size, link, and parent information for a known item.

Refresh metadata for an item returned by an earlier action.

Requirements

A connected Microsoft 365 connection for this HighLevel Location.
The Drive ID of the approved SharePoint document library.
The Item ID of the file or folder.

Inputs

Action inputs
Input	Type	Required	Description	Example value
`Document Library (Drive ID)`	string	Yes	Microsoft Graph Drive ID for the SharePoint document library. The Drive ID identifies the library itself and can be reused across workflow actions.	`b!exampleDriveId123`
`Item ID`	string	Yes	Microsoft Graph DriveItem ID of the SharePoint file or folder. Usually map this from a previous action such as Get Item By Path, Search Items, or List Folder Items.	`example-item-id`

Example values

Document Library (Drive ID): b!exampleDriveId123
Item ID: example-item-id

Example workflow

Example action workflow

HighLevel workflow trigger
The business event that starts the workflow.
SharePoint - Get Item
Run the SharePoint operation with the approved Drive ID and action-specific inputs.
Use the confirmed result
Map only the documented outputs required by the next workflow step.

A common pattern is: earlier action returns Item ID → Get Item → use the refreshed metadata in a later workflow step.

Outputs

Action outputs
Output	Type	Description	Example value	Use in later steps
`Success`	boolean	Confirms that the action completed successfully.	`true`	Use as a completion checkpoint before relying on other outputs.
`Item ID`	string	Microsoft Graph DriveItem ID of the resulting file or folder.	`example-item-id`	Map into Get Item, Move Item, Rename Item, Delete Item, or other ID-based steps.
`Item Name`	string	Current name of the file or folder.	`Example Document.pdf`	Use for confirmation, messages, or later naming logic.
`Web URL`	string	SharePoint web link for the resulting file or folder.	`https://example.invalid/Example%20Document.pdf`	Use when a later step or staff member needs the SharePoint link.
`Item Type`	string	Normalized item type such as file or folder.	`file`	Use to distinguish file and folder results.
`Size`	numerical	Item size in bytes.	`24576`	Use for file-size checks or audit information.
`MIME Type`	string	MIME type for a file when Microsoft returns one.	`application/pdf`	Use when later logic depends on the returned file type.
`Last Modified`	date	Microsoft last-modified timestamp for the item.	`2026-09-22T20:00:00Z`	Use for audit or freshness checks.
`Parent Item ID`	string	DriveItem ID of the resulting parent folder.	`example-parent-folder-id`	Use when later logic needs the resulting parent folder ID.

How to use outputs in later HighLevel steps

Success: Use as a completion checkpoint before relying on other outputs.
Item ID: Map into Get Item, Move Item, Rename Item, Delete Item, or other ID-based steps.
Item Name: Use for confirmation, messages, or later naming logic.
Web URL: Use when a later step or staff member needs the SharePoint link.
Item Type: Use to distinguish file and folder results.
Size: Use for file-size checks or audit information.
MIME Type: Use when later logic depends on the returned file type.
Last Modified: Use for audit or freshness checks.
Parent Item ID: Use when later logic needs the resulting parent folder ID.

Use Item Type to distinguish files and folders. Web URL, MIME Type, Size, Last Modified, and Parent Item ID are available for later steps.

Permissions required

Microsoft Graph application permission Sites.Selected on the customer-owned Entra app.
The SharePoint site containing the document library must grant the app at least read access for this operation.
The action does not require tenant-wide SharePoint access merely for discovery or name matching.

Common errors

Authentication unavailable / 401: This HighLevel Location does not have a usable Microsoft connection. Verify the Location connection before changing SharePoint permissions.
403: The Entra app lacks access to the selected SharePoint site or the granted role is too narrow for the operation. Verify Sites.Selected consent and the site's read grant.
404: The Drive ID, folder path, or Item ID does not resolve in the connected tenant and approved site. Recheck the administrator's Drive ID map and the exact path or Item ID.
429: Microsoft Graph throttled the request. Retry later and avoid high-volume loops without bounds.

Product/action version

Product version: Pre-launch technical release · 2026-10-04
Action version: 1.1
Implementation reference: Integration commit 8440a0f · src/modules/workflows/actions/sharepoint-get-item.json · code/sharepoint_get_item.1.1.js

Last updated

2026-10-07