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


Path parameters



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


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:


For more information, see the Authentication Overview.