Contact UsGet started

How to get started with browser push notifications in Yandex Cloud Notification Service

Written by
Updated at May 7, 2025

Note

The service is at the preview stage.

To enable Cloud Notification Service, request access to the service from your account manager or technical support.

Cloud Notification Service (CNS) is a service for multichannel notifications of users. The service's HTTP API is compatible with the Amazon SNS API.

With Cloud Notification Service, you can send push notifications to users' browsers.

To get started with push notifications:

  1. Get your cloud ready.
  2. Create an in-browser push notification channel.
  3. Get the data you need to send to notifications to a user.
  4. Create an endpoint.
  5. Send a notification.

Get your cloud ready

Sign up in Yandex Cloud and create a billing account:

  1. Navigate to the management console and log in to Yandex Cloud or register a new account.
  2. On the Yandex Cloud Billing page, make sure you have a billing account linked and it has the ACTIVE or TRIAL_ACTIVE status. If you do not have a billing account, create one and link a cloud to it.

If you have an active billing account, you can navigate to the cloud page to create or select a folder for your infrastructure to operate in.

Learn more about clouds and folders.

Create an in-browser push notification channel

In Cloud Notification Service, messages to end users are sent through notification channels.

To create a channel:

  1. In the management console, select the folder you want to create a notification channel in.

  2. From the list of services, select Cloud Notification Service.

  3. Click Create notifications channel.

  4. Select the Push notifications in browser tab.

  5. Enter a name for your notification channel. The channel name must be unique within Cloud Notification Service.

  6. Click Create.

    Creating a notification channel may take some time.

Get the data you need to send to notifications to a user

For each channel, you need to create a set of endpoints through which to send notifications to specific users' browsers.

To create an endpoint, get this user data:

  1. From the user's browser, use Service Worker to call the JavaScript subscribe method.

    The PushSubscription object will be returned in response.

  2. Convert the object you got into JSON by calling the toJSON method.

Example of subscription parameters in JSON
{
 "endpoint": "https://fcm.googleapis.com/fcm/send/abcdef123456",
 "expirationTime": 1704093740000,
 "keys": {
   "p256dh": "BOrLkr7sEt8tERyAv6c8ZG5UC********",
   "auth": "aBcDeFg12345"
 }
}

Create an endpoint

  1. Select the notification channel you created.
  2. Select the Endpoints tab.
  3. Click Create endpoint.
  4. Enter the Endpoint parameters in JSON you received in the user’s browser.
  5. Click Create.

Send a notification

  1. Select the endpoint you created.
  2. Enter the notification text.
  3. Click Send.

Each sent notification is assigned a unique ID. To save it, click Copy ID.

See also

Previous
Getting started with mobile push notifications
Next
Getting started with SMS