Send an app notification

You can use the App Integrations API to send an app notification to sellers.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API Applications.
• The Notifications in Seller Central role assigned to your developer profile.
• The Notifications in Seller Central role selected in the App Registration page for your application.
• A notification template for your app.

Create an app notification

Call the createNotification operation.

❗

Warning

The parameters in the API request body must be the same as the parameters in your app notification template.

Request example

The following request example uses the PRICE_CHANGE example app notification template.

POST https://sellingpartnerapi-na.amazon.com/appIntegrations/2024-04-01/notifications
{
    "templateId": "PRICE_CHANGE",
    "marketplaceId": "ATVPDKIKX0DER",
    "notificationParameters": {}
}

Response

A successful response includes the unique notification ID. For example:

Status code: 200
{
    "notificationId": "47f05db0-03fe-11ed-b939-0242ac120002"
}