PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync() | createPushNotificationChannelForApplicationAsync() method

Applies to Windows and Windows Phone

Creates an object, bound to the calling app, through which you retrieve a push notification channel from Windows Push Notification Services (WNS).


Windows.Networking.PushNotifications.PushNotificationChannelManager.createPushNotificationChannelForApplicationAsync().done( /* Your success and error handlers */ );


This method has no parameters.

Return value

Type: IAsyncOperation<PushNotificationChannel>

The object, bound to the calling app, that is used to request a PushNotificationChannel from the WNS.


Tile update, toast, and badge notifications that arrive on this channel are delivered to the app's main or default tile.

An exception is thrown if you attempt to register a WNS push notification channel when there is no data connection. For a list of error codes that can be received, see CreatePushNotificationChannelForApplicationAsync.


The following example shows the use of this method to retrieve a channel for the calling app.

var pushNotifications = Windows.Networking.PushNotifications;
var channel;

function openNotificationsChannel() {
    var channelOperation = pushNotifications.PushNotificationChannelManager.createPushNotificationChannelForApplicationAsync();
    return channelOperation.then(function (newChannel) {
        channel = newChannel;


Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]


Windows::Networking::PushNotifications [C++]



See also

WNS overview
Push and periodic notifications sample
Quickstart: Sending a tile push notification
Quickstart: Sending a toast push notification
How to update a badge through push notifications
How to authenticate with the Windows Push Notification Service (WNS)
How to request, create, and save a notification channel
Guidelines and checklist for push notifications
Push notification service request and response headers



© 2014 Microsoft