Windows (WNS)
WNS notifications for Windows apps associated with the Microsoft Store — no package required; the channel URI is written to the SDK registration endpoint.
Windows apps associated with the Microsoft Store (MSIX-packaged) receive notifications through Windows Push Notification Services (WNS)
on the wns_push channel. There is no separate Pushizo package: the app gets its channel URI with the Windows SDK's channel API
and writes it to the SDK registration endpoint. The server side (sending, authentication, URI validation)
is described in ADR-0052.
1. Partner Center and Visual Studio
- Partner Center → your app → Product identity: Package SID (
ms-app://s-1-15-2-…). - Partner Center → your app → WNS/MPNS: Client secret.
- Visual Studio → project → Publish → Associate App with the Store. This association binds the Package SID to the app.
2. Dashboard
Channels → Windows Notification Service (or the Windows (WNS) card in the setup wizard): enter the Package SID and Client Secret. They're validated against the WNS OAuth endpoint when you save; the secret is stored encrypted on the server and never shown again.
3. App code (C#)
In the dashboard, Getting started → SDK code → Windows (WNS) gives you this code with your App ID and API URL filled in.
using System.Net.Http.Json;
using System.Text.Json;
using System.Text.Json.Serialization;
using Windows.Networking.PushNotifications;
public static class PushizoWindows
{
private static readonly HttpClient Http = new();
private static readonly JsonSerializerOptions Json = new() { DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull };
// Call on every launch: the channel URI changes over time, and the same URI doesn't create a second subscription.
public static async Task RegisterAsync(string? externalId = null)
{
var channel = await PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync();
var timezone = TimeZoneInfo.TryConvertWindowsIdToIanaId(TimeZoneInfo.Local.Id, out var iana) ? iana : null;
var body = new
{
channel = "wns_push",
token = channel.Uri,
device = new { os = "Windows", os_version = Environment.OSVersion.Version.ToString(), sdk_platform = "windows", locale = System.Globalization.CultureInfo.CurrentUICulture.Name, timezone },
user = externalId is null ? null : new { external_id = externalId },
};
var response = await Http.PostAsJsonAsync("https://api.pushizo.com/sdk/v1/apps/<APP_ID>/subscriptions", body, Json);
response.EnsureSuccessStatusCode();
}
}- Registration via
POST /sdk/v1/apps/{appId}/subscriptions(channel: "wns_push",token= channel URI) is idempotent. - When sending, requests go only to
https://*.notify.windows.comURIs; a subscription with any other URI is marked as an invalid token and closed. - The notification is sent as
wns/toast(ToastGeneric: title + body); if the notification has a URL, it's written to the toast'slaunchvalue. - To map the user to your own ID, pass
externalId(user.external_id). - When WNS responds that a channel is expired or invalid, the subscription is closed on the server.
Limitations
- There's no click/open tracking (the toast doesn't carry a delivery ID); delivery and error statuses are reported.
- In-app messages, the notification inbox, and location features aren't available on Windows. On the Windows target of the .NET MAUI SDK these calls have no effect; to send notifications to Windows with MAUI, use the registration code on this page.
Kotlin Multiplatform
com.pushizo:pushizo-kmp — calls the native Android and iOS SDKs from shared Kotlin code. Maven Central release is in preparation.
Node.js SDK
@pushizo/node — Node.js ≥ 20, ESM, types derived from OpenAPI; notifications, users, events, webhook signature verification, journeys, and the entire public API.