Skip to main content

spo folder add

Creates a folder within a parent folder


m365 spo folder add [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 for more information and examples.

-o, --output [output]

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


Runs command with verbose logging.


Runs command with debug logging.


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

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


Creates folder in a specific library within the site.

m365 spo folder add --webUrl --parentFolderUrl '/Shared Documents' --name 'My Folder Name'

Creates folder in a specific folder within the site.

m365 spo folder add --webUrl --parentFolderUrl '/sites/project-x/Shared Documents/Reports' --name 'Financial reports'

Create a folder with a dark blue look

m365 spo folder add --webUrl --parentFolder '/ProjectFiles' --name 'Project-x' --color 5

Create a folder with a light teal look

m365 spo folder add --webUrl --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 --parentFolderUrl '/Projects/2024/Q1/Reports' --name Financial --ensureParentFolders


"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": ""