---
title: "Create Dashboard"
method: POST
path: "/api/v1/dashboards"
tags: ["dashboards"]
---

# Create Dashboard

`POST /api/v1/dashboards`

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable

## Request body

- DashboardCreate
  - `name` string, required
  - `description` string, nullable
  - `folder_id` integer, nullable
  - `visibility` 'private' | 'public' | 'shared'
  - `settings` object

## Response `201`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-27** `db5ab8f1fcef` — 1 breaking, 1 warning, 3 info
  - the `name` request property's minLength was increased from `0` to `1`
  - the `name` request property's maxLength was set to `255`
  - added the new optional request property `folder_id`
  - added the new optional request property `settings`
  - …1 more

[Change history](https://skmtc.dev/ninjavan/apis/salesforce-sales-cloud-replacement/changes/api/v1/dashboards/post.md)

---

[API](https://skmtc.dev/ninjavan/apis/salesforce-sales-cloud-replacement.md) · [All operations](https://skmtc.dev/ninjavan/apis/salesforce-sales-cloud-replacement/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ninjavan/salesforce-sales-cloud-replacement/revisions/ce7abafbb050/schema)