Notification Release Notes

1.6.3

The following changes have been made in this release.

This release adds one notification topic. See Select a notification topic for additional information.

• LISTING_PREVIEW_CREATION_TASK_STATUS: This notification is sent to sellers to inform them when any of their listing preview creation tasks have completed.

  Note: This notification topic can only be used by developers who have access to the restricted Inventory Mapping API.

1.6.2

The following changes have been made in this release.

This release adds one notification topic. See Select a notification topic for additional information.

• BUYER_REQUESTED_PURCHASE_QUOTE: This notification is sent to the seller, or a third-party application authorized by the seller, when a buyer requests the total price for the order before paying. This order may have one or multiple item commitments which will be identified along with quantity in the notification payload.

1.6.1

The following changes have been made in this release.

This release adds sandbox support for all methods in the Notification API. To access the sandbox endpoint, just replace the api.ebay.com root URI with api.sandbox.ebay.com. Support was also added to the API explorer.

1.6.0

The following changes have been made in this release.

This release adds two notification topics. See Select a notification topic for additional information.

• SELLER_CUSTOMER_SERVICE_METRIC_RATING: This notification is sent to sellers to inform them about critical changes to their customer service metrics performance (this includes proactive warnings when their service metrics are trending towards 'very high'). The payload for this notification is similar to the Analytics API getCustomerServiceMetric method.
• SELLER_STANDARDS_PROFILE_METRICS: This notification is sent to sellers to inform them about critical changes to their seller performance metrics and seller level (this includes proactive warnings when their performance metrics are close to the threshold that could change the seller's standard level). The payload for this notification is similar to the Analytics API findSellerStandardsProfiles method.

1.5.1

The following changes have been made in this release.

Adds two error codes to the createSubscriptionFilter method. See Creating a subscription filter for a topic for additional information.

Code	Meaning
195032	The specified subscription topic is not filterable.
195033	The specified 'filterSchema' value is invalid.

1.5.0

The following changes have been made in this release.

This release adds the following new notification topic:

• PRIORITY_LISTING_REVISION: Developers who are subscribed to this topic receive a push notification when their Priority Listing has been revised.

1.4.0

The following changes have been made in this release.

This release adds three new methods: createSubscriptionFilter, getSubscriptionFilter, and deleteSubscriptionFilter.

• createSubscriptionFilter: This method allows applications to create a filter for a subscription. Filters allow applications to only send notifications when they match a provided criteria.
• getSubscriptionFilter: This method allows applications to retrieve the filter details for the specified subscription filter.
• deleteSubscriptionFilter: This method allows applications to disable an active filter on a subscription.

A new field, filterable, has been added to in the getTopic response to indicate if the topic is filterable or not.

A new field, filterId, has been added to the getSubscription response that holds the id of the filter applied to the subscription.

1.3.0

The following changes have been made in this release.

Full details on the release (e.g., This release includes new API endpoints for product search, allowing developers to easily query product data.).

1.2.0

The following changes have been made in this release.

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.

1.1.0

The following changes have been made in this release.

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.

1.0.0

The following changes have been made in this release.

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.