Skip to main content

notification APIv1.2.0

Notification API release notes

Just getting started with the Notification API? See the following documents for details on using this API:

The API release history

The following table lists the releases for the Notification API:

Version

Release Date

Summary of Release

Version 1.2.0

2021-09-15

Enabled the authorization code grant flow for user-based subscriptions in the subscription resource methods

Version 1.1.0

2021-06-30

Added four new resources

Version 1.0.0

2021-03-22

Initial release of Version 1.0.0

Version 1.2.0

This release adds the following new OAuth authorization code scopes to the subscription resource in order to support user-based subscriptions: 

https://api.ebay.com/oauth/api_scope/commerce.notification.subscription

https://api.ebay.com/oauth/api_scope/commerce.notification.subscription.readonly

These new scopes enable the creation of user-based subscriptions to notification topics using the authorization code grant flow. When creating user-based subscriptions, the new scopes must be included when the OAuth token is minted.

Similarly, when retrieving subscriptions using the getSubscription or getSubscriptions method, the appropriate scopes must be included in the OAuth token in order to view application-based (using the client credentials grant flow) or user-based (using the authorization code grant flow) subscriptions for a topic.

Tip: See the Notification overview page for more information about how subscription services work.

Version 1.1.0

This release adds the following new resources to the Notification API: 

  • topic - This resource enables users to browse supported notification topics and retrieve details for those topics.

  • config - This resource enables users to create, update, and retrieve alert configuration details.

  • destination - This resource enables users to create and manage the destination endpoints that will receive notifications.

  • subscription - This resource enables users to create, manage, and test their notification subscriptions.

Tip: See the Notification overview page for more information about how these new methods can be used to manage eBay notification preferences.

Version 1.0.0

This is the initial release of the Notification API, Version 1.0.0. For a list of the new resource and methods, see the Notification API Reference.