Method: projects.alertPolicies.create

Creates a new alerting policy.

Design your application to single-thread API calls that modify the state of alerting policies in a single project. This includes calls to alertPolicies.create, alertPolicies.delete and alertPolicies.patch.

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. |name| must be a host project of a Metrics Scope, otherwise INVALID_ARGUMENT error will return. 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.