# system.kanoa.dashboard.addDashboard(dashboardInfo, userId)

Create a new dashboard.

---
### Parameters
**dashboardInfo** `Dictionary`<br />
<table class='dictionaryKeyTable'>
	<tbody>
 	<tr><td> - dashboardDescription</td><td>String</td><td>Some information about the dashboard.</td></tr>	
 	<tr><td> - dashboardName</td><td>String</td><td>The name of the dashboard. This must be unique within the folder.</td></tr>	
 	<tr><td> - enabled</td><td>Boolean</td><td></td></tr>	
 	<tr><td> - folderId</td><td>Integer</td><td>The id of the folder this dashboard is going into. Use None if the dashboard is going onto the root.</td></tr>	
 	<tr><td> - iconColor</td><td>String</td><td>The color of the icon for this dashboard.</td></tr>	
 	<tr><td> - iconPath</td><td>String</td><td>The path to the icon for this dashboard.</td></tr>	
 	<tr><td> - private</td><td>Boolean</td><td>Indicates if the dashboard is private or public. True for private, False for public</td></tr>	
 	<tr><td> - roles</td><td>List of Strings</td><td>An array of roles that are able to view this dashboard.</td></tr>	
 	<tr><td> - showOnMobile</td><td>Boolean</td><td>Indicates if the dashboard should be shown on mobile devices.</td></tr>	
 	<tr><td> - sortOrder</td><td>Integer</td><td>Determines where within the folder the dashboard is placed relative to other dashboards. If the same as another dashboard, then sorted by name.</td></tr>	
	</tbody>
</table>

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

---
### Returns
**dashboardId** `Integer`<br />
**message** `String` None if successful<br />

---
### Example
```python
dashboardInfo = {
  "dashboardDescription": "Downtime By Asset",
  "dashboardName": "Asset Downtime",
  "enabled": True,
  "folderId": 1,
  "iconColor": "#AC5F00",
  "iconPath": "kanoa/maintenance",
  "private": False,
  "roles": None,
  "showOnMobile": false,
  "sortOrder": None
}
userId = 123
dashboardId, msg = system.kanoa.dashboard.addDashboard(dashboardInfo, userId)
if msg:	system.perspective.sendMessage('showFailerToast', msg)
else: system.perspective.sendMessage('showSuccessfulToast', 'Dashboard has been saved')
```