---
title: "Create Metric Dashboard"
method: POST
path: "/v1/metrics/dashboards"
tags: ["metrics", "public"]
---

# Create Metric Dashboard

`POST /v1/metrics/dashboards`

Create a user-defined metric dashboard.

**Scopes**: `metrics:write`

## Request body

- MetricDashboardCreate — Schema for creating a metrics dashboard.
  - `name` string, required — Display name for the dashboard.
  - `metrics` string[] — List of metric slugs to display in this dashboard.
  - `organization_id` string, uuid4, nullable — The organization ID.

## Response `201`

Successful Response

- MetricDashboardSchema — A user-defined metrics dashboard.
  - `created_at` string, date-time, required — Creation timestamp of the object.
  - `modified_at` string, date-time, nullable, required — Last modification timestamp of the object.
  - `id` string, uuid4, required — The ID of the object.
  - `name` string, required — Display name for the dashboard.
  - `metrics` string[], required — List of metric slugs displayed in this dashboard.
  - `organization_id` string, uuid4, required — The ID of the organization owning this dashboard.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/polar/apis/polar-api.md) · [All operations](https://skmtc.net/polar/apis/polar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polar/polar-api/revisions/77e4ef94fcc3/schema)