Creates a new custom dashboard. For examples on how you can use this API to create dashboards, see Managing dashboards by API. This method requires the monitoring.dashboards.create permission on the specified project. For more information about permissions, see Cloud Identity and Access Management.
HTTP request
POST https://monitoring.googleapis.com/v1/{parent}/dashboards
Path parameters
Parameters
parent
string
Required. The project on which to execute the request. The format is:
projects/[PROJECT_ID_OR_NUMBER]
The [PROJECT_ID_OR_NUMBER] must match the dashboard resource name.
Authorization requires the following IAM permission on the specified resource parent:
monitoring.dashboards.create
Query parameters
Parameters
validateOnly
boolean
If set, validate the request and preview the review, but do not actually save it.
Request body
The request body contains an instance of Dashboard.
Response body
If successful, the response body contains a newly created instance of Dashboard.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-23 UTC."],[],[],null,["# Method: projects.dashboards.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a new custom dashboard. For examples on how you can use this API to create dashboards, see [Managing dashboards by API](https://cloud.google.com/monitoring/dashboards/api-dashboard). This method requires the `monitoring.dashboards.create` permission on the specified project. For more information about permissions, see [Cloud Identity and Access Management](https://cloud.google.com/iam).\n\n### HTTP request\n\n`POST https://monitoring.googleapis.com/v1/{parent}/dashboards`\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Dashboard](/monitoring/api/ref_v3/rest/v1/projects.dashboards#Dashboard).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Dashboard](/monitoring/api/ref_v3/rest/v1/projects.dashboards#Dashboard).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/monitoring`\n- `\n https://www.googleapis.com/auth/monitoring.write`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]