# system.kanoa.dashboard.addFolder(folderInfo, userId)

Create a new folder for storing dashboards

---
### Parameters
**folderInfo** `Dictionary`<br />
<table class='dictionaryKeyTable'>
	<tbody>
 	<tr><td> - folderDescription</td><td>String</td><td></td></tr>	
 	<tr><td> - folderName</td><td>String</td><td>The name of the folder. This must be unique within the parent folder.</td></tr>	
 	<tr><td> - icon</td><td>String</td><td>The path to the icon for this folder.</td></tr>	
 	<tr><td> - iconColor</td><td>String</td><td>The color of the icon for this folder.</td></tr>	
 	<tr><td> - parentId</td><td>Integer</td><td>The id of the parent this folder is going into. Use None if the folder is going onto the root.</td></tr>	
 	<tr><td> - roles</td><td>[string]</td><td>An array of roles that are able to view this folder.</td></tr>	
 	<tr><td> - sortOrder</td><td>Integer</td><td>Determines the folders order within the folder. If None, then sorted by name</td></tr>	
	</tbody>
</table>

**userId** `Integer`: Id of user executing the function<br />

---
### Returns
**folderId** `Integer`<br />
**message**  (string) None if successful<br />

---
### Example
```python
folderInfo = {
  "folderName": "Jason's Dashboards",
  "folderDescription": None,
  "icon": None,
  "iconColor": None,
  "parentId": None,
  "roles": None,
  "sortOrder": None
}
userId = 123
folderId, msg = system.kanoa.dashboard.addFolder(folderInfo, userId)
if msg:	system.perspective.sendMessage('showFailerToast', msg)
else: system.perspective.sendMessage('showSuccessfulToast', 'Folder has been saved')
>
```