Method: projects.dashboards.create

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


Path parameters



Required. The project on which to execute the request. The format is:


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

Request body

The request body contains an instance of Dashboard.

Response body

If successful, the response body contains a newly created instance of Dashboard.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.