Edit

Share via

Onboarding to cross-device experiences for Microsoft Graph notifications (deprecated)

  • Article

Important

The Microsoft Graph notifications API is deprecated and stopped returning data in January 2022. For an alternative notification experience, see Microsoft Azure Notification Hubs. For more information, see the blog post Retiring Microsoft Graph notifications API (beta).

Note

If you're only targeting web endpoints, you can go directly to setting up your app service to send notifications.

In addition to app registration on the Microsoft Entra admin center, your application needs to register cross-device information such as cross-platform application ID and cross-platform push credentials in order to authorize Microsoft Graph to send notifications via native push notification services that correspond to each operating system: Windows, iOS, and Android. This is done through the Partner Center dashboard (formerly Windows Dev Center dashboard).

Note

You'll need a Windows developer account to complete the steps in this article, even if you don't plan to build a Windows UWP application. If you don't already have a Windows developer account, see Opening a developer account. Alternatively, if you prefer not to enroll as a Windows developer, you can reach out to us via email at [gnsengage@microsoft.com](sendto: gnsengage@microsoft.com). If you create a Windows developer account and are building a school or work application as part of an enterprise, you can associate your developer account with the appropriate Microsoft Entra account that is used for managing your enterprise submissions. For details, see Associate Microsoft Entra ID with your Partner Center account.

To get started, sign in to the Partner Center dashboard using your Windows developer account:

  1. On the left menu, go to Cross-Device Experiences, select Configuring a new cross-device app, and provide your app name, as shown in the following screenshot.

Configure a new cross-device app registration

  1. Select all supported platforms where your app will have a presence and be enabled to receive notifications. You can select from supported platforms that include Windows, Android, and iOS, as shown. 

  2. Provide app IDs for each of the platforms where your app has a presence, as shown.

Provide platform-specific app ids

Note

You can add different IDs (up to ten) per platform – this is in case you have multiple versions of the same app, or even different apps, that want to be able to receive the same notification sent by your app server and targeted to the same user.

  1. Provide or select the app ID from Microsoft account and/or Microsoft Entra app registration. This client ID corresponds to the Microsoft account or Microsoft Entra app registration that you obtained when you register in the Microsoft Entra admin center.

Provide Azure app registration client ids for MSA and Microsoft Entra ID

  1. Microsoft Graph notifications use each of the native notification platforms on all major platforms to send notifications to the app client endpoints, namely, WNS (for Windows UWP), FCM (for Android), and APNS (for iOS). Provide your credentials for these notification platforms to enable Microsoft Graph notifications to deliver notifications for your app server when you publish user-targeted notifications, as shown.

Note

For Windows UWP apps, enabling WNS push notification is a prerequisite to using Microsoft Graph notifications. For details, see WNS overview. After you onboard, you can provide push credentials via Partner Center to the Connected Device Platform.

  1. Verify your cross-device app domain, which serves as a verification process to prove that your application has ownership of this domain. This acts like a cross-device app identity for the application or applications you registered, as shown.

That's it! You've now registered your applications to receive notifications. Next, learn how to set up your app service and start sending notifications.