Method: projects.notificationChannels.create

Creates a new notification channel, representing a single notification endpoint such as an email address, SMS number, or PagerDuty service.

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

HTTP request

POST https://monitoring.googleapis.com/v3/{name}/notificationChannels

Path parameters

Parameters
name

string

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

projects/[PROJECT_ID_OR_NUMBER]

This names the container into which the channel will be written, this does not name the newly created channel. The resulting channel's name will have a normalized version of this field as a prefix, but will add /notificationChannels/[CHANNEL_ID] to identify the channel.

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

  • monitoring.notificationChannels.create

Request body

The request body contains an instance of NotificationChannel.

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/monitoring

For more information, see the Authentication Overview.