---
source_url: https://www.pubnub.com/docs/admin-api/create-dashboard
title: Create dashboard
---

# Create dashboard

> For AI agents: documentation index at https://www.pubnub.com/llms-full.txt

Creates a new dashboard to visualize metrics with optional decision overlays.

### Conditional fields

| Field | Condition |
| --- | --- |
| `startDate` | Required when `dateRange` is `"Custom date"` |
| `endDate` | Required when `dateRange` is `"Custom date"` |
| `customerId` | Can only be set on create (not updatable). Requires Partner Portal. |

Each chart in the `charts` array references a metric by `{ id: "metric-uuid" }` and can optionally overlay decisions via `decisionIds`.

## Request

Example

```
{
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "createdBy": "string",
  "updatedBy": "string",
  "id": "string",
  "name": "string",
  "accountId": "string",
  "dateRange": "30 minutes",
  "startDate": "2024-01-01T00:00:00.000Z",
  "endDate": "2024-01-01T00:00:00.000Z",
  "charts": [
    {
      "id": "access_manager_by_metric",
      "series": [
        {}
      ]
    }
  ],
  "customer": {
    "id": "string",
    "name": "string"
  }
}
```