Method: projects.alertPolicies.create

Creates a new alerting policy.

HTTP request


Path parameters



Required. The project in which to create the alerting policy. The format is:


Note that this field names the parent container in which the alerting policy will be written, not the name of the created policy. The alerting policy that is returned will have a name that contains a normalized representation of this name as a prefix but adds a suffix of the form /alertPolicies/[ALERT_POLICY_ID], identifying the policy in the container.

Authorization requires the following IAM permission on the specified resource name:

  • monitoring.alertPolicies.create

Request body

The request body contains an instance of AlertPolicy.

Response body

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

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.

Try it!