SharePoint - Create Folder

What it does

Create a new folder in an approved SharePoint document library and return its ID and web link. The action stops if the name already exists.

Use Create Folder when an existing folder with the same name should stop the workflow. If repeated runs should safely reuse the same folder, use Find or Create Folder instead.

When to use it

Create a client, case, project, or process folder from a HighLevel workflow.
Create one folder when a duplicate should be treated as a conflict rather than silently reused.

Create a client, case, project, or process folder from a HighLevel workflow.

Requirements

A connected Microsoft 365 connection for this HighLevel Location.
The Drive ID of the approved SharePoint document library.
A parent folder path when the new folder should not be created at the library root.

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`
`Parent Folder Path`	string	No	Folder path inside the selected document library, for example Customers/Acme Ltd. Do not include the document library name. Leave empty to use the document library root.	`Customers/Example Client`
`Folder Name`	string	Yes	Name of the new folder. An existing name causes a conflict.	`Contracts`

Example values

Document Library (Drive ID): b!exampleDriveId123
Parent Folder Path: Customers/Example Client
Folder Name: Contracts

Example workflow

Example action workflow

HighLevel workflow trigger
The business event that starts the workflow.
SharePoint - Create Folder
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: HighLevel trigger → Create Folder → map Folder ID or Web URL into a later 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.
`Folder ID`	string	Microsoft Graph DriveItem ID of the folder.	`example-folder-id`	Map into a later step that needs this folder's Item ID.
`Folder Name`	string	Folder name returned by SharePoint.	`Example Folder`	Use in messages, audit text, or later naming logic.
`Web URL`	string	SharePoint web link for the resulting file or folder.	`https://example.invalid/Example%20Folder`	Use when a later step or staff member needs the SharePoint link.

How to use outputs in later HighLevel steps

Success: Use as a completion checkpoint before relying on other outputs.
Folder ID: Map into a later step that needs this folder's Item ID.
Folder Name: Use in messages, audit text, or later naming logic.
Web URL: Use when a later step or staff member needs the SharePoint link.

Use Folder ID when another action needs the created folder as a resource. Use Web URL when a later step needs a human-readable SharePoint link.

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 write 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 write 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.
409: A destination name or state conflicts with an existing SharePoint item. Inspect the destination and choose the intended duplicate/conflict behavior before retrying.
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.2
Implementation reference: Integration commit 8440a0f · src/modules/workflows/actions/sharepoint-create-folder.json · code/sharepoint_create_folder.1.2.js

Last updated

2026-10-07