> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# createDashboard

> Creates a dashboard. Requires `dashboard:create`.



**mutation** `createDashboard(input: CreateDashboardInput!): CreateDashboardOutput!`

## Arguments

**`input`**: `CreateDashboardInput!` (required)

## Returns

`CreateDashboardOutput!`

**`dashboard`**: `Dashboard`

---

**`error`**: `MutationError`

## Examples

```graphql Mutation
mutation CreateDashboard($input: CreateDashboardInput!) {
  createDashboard(input: $input) {
    dashboard {
      id
      name
      globalRange {
        __typename
        ... on DashboardPresetRange {
          __typename
        }
      }
      globalFilters
      widgets {
        id
        kind
        chartType
        config {
          __typename
          ... on DashboardChartWidgetConfig {
            __typename
          }
        }
        layout {
          __typename
        }
        position
      }
      createdAt {
        unixTimestamp
        iso8601
      }
    }
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}
```

```json Variables
{
  "input": {
    "name": "string"
  }
}
```

```json Response
{
  "data": {
    "createDashboard": {
      "dashboard": {
        "id": "id",
        "name": "string",
        "globalRange": {
          "__typename": "DashboardPresetRange"
        },
        "globalFilters": "string",
        "widgets": [
          {
            "id": "id",
            "kind": "TIMESERIES",
            "chartType": "BAR",
            "config": {
              "__typename": "DashboardChartWidgetConfig"
            },
            "layout": {
              "__typename": "DashboardWidgetLayout"
            },
            "position": 1
          }
        ],
        "createdAt": {
          "unixTimestamp": "string",
          "iso8601": "string"
        }
      },
      "error": {
        "message": "string",
        "type": "VALIDATION",
        "code": "string",
        "fields": [
          {
            "field": "string",
            "message": "string",
            "type": "VALIDATION"
          }
        ]
      }
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.