Skip to main content

spo folder add

Creates a folder within a parent folder

Usage

m365 spo folder add [options]

Options

-u, --webUrl <webUrl>

The URL of the site where the folder will be created.

-p, --parentFolderUrl <parentFolderUrl>

The server- or site-relative decoded URL of the parent folder.

-n, --name <name>

Name of the new folder to be created.

--color [color]

Visual color of the folder. Valid values are a color name or a number. Check remarks for more info.

--ensureParentFolders [ensureParentFolders]

Ensure that the parent folder path is available. Any missing folders will be created recursively.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks

When you specify a value for color, consider the following:

ColorNumber valueString value
Yellow0yellow
Dark red1darkRed
Dark orange2darkOrange
Dark green3darkGreen
Dark teal4darkTeal
Dark blue5darkBlue
Dark purple6darkPurple
Dark pink7darkPink
Grey8grey
Light red9lightRed
Light orange10lightOrange
Light green11lightGreen
Light teal12lightTeal
Light blue13lightBlue
Light purple14lightPurple
Light pink15lightPink

Examples

Creates folder in a specific library within the site.

m365 spo folder add --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents' --name 'My Folder Name'

Creates folder in a specific folder within the site.

m365 spo folder add --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/sites/project-x/Shared Documents/Reports' --name 'Financial reports'

Create a folder with a dark blue look

m365 spo folder add --webUrl https://contoso.sharepoint.com --parentFolder '/ProjectFiles' --name 'Project-x' --color 5

Create a folder with a light teal look

m365 spo folder add --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color lightTeal

Create a folder and make sure that any missing folders specified as parent folders are created.

m365 spo folder add --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Projects/2024/Q1/Reports' --name Financial --ensureParentFolders

Response

{
"Exists": true,
"ExistsAllowThrowForPolicyFailures": true,
"IsWOPIEnabled": false,
"ItemCount": 0,
"Name": "My new folder",
"ProgID": null,
"ServerRelativeUrl": "/sites/project-x/Shared Documents/My new folder",
"TimeCreated": "2023-07-20T19:29:16Z",
"TimeLastModified": "2023-07-20T19:29:16Z",
"UniqueId": "94a9aa56-f0b5-4268-941f-737c841ba7c7",
"WelcomePage": ""
}
CTRL + M