Use the notifications REST API in Microsoft Graph


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

You can use the notifications API in Microsoft Graph to send push notifications to a user. Simply post a notification to your target user, and the platform will deliver the notification to all device endpoints registered to that user. The high-level flow is as follows:

  1. User signs in to your application, which creates a subscription with the Microsoft Graph notification service. A specific user notification subscription ID or UNSID will be returned to the calling application.
  2. The application sends this UNSID to your application service.
  3. When ready to send a notification, your application service authenticates with the Microsoft identity platform and posts a notification via the Microsoft Graph notification service, providing the auth token, target user's UNSID, and notification payload.
  4. The Microsoft Graph notification service fans-out notifications to all endpoints of the user with an active subscription.

This type of user-centric notification is represented by the notification resource and is stored within the Microsoft Graph notification service. It can then be accessed and managed by the client application via the client-side SDK APIs. If you're new to the Microsoft Graph notification service, check out the notification overview section to learn more.

What's new

Find out about the latest new features and updates for this API set.

Next steps