reportItemsBackInStock( )
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Sends notifications for back in stock requests.
Important: Automations must be turned on in a site's dashboard for notifications to send.
This endpoint triggers notifications for requests in 1 of 2 ways:
- For a specific item, with the
catalogReference
information. - For specific requests, with
requestIds
.
itemDetails
are required and may populate dynamic values in the notification template, as follows:
itemDetails.name
passes to the template asitem.name
itemDetails.price
passes to the template asitem.price
itemDetails.image.url
passes to the template asitem.image.url
If the notification template doesn't include item.price
, item.name
, or item.image.url
, values should
be passed in extraAutomationTemplateParameters
.
After this endpoint is called, the status
for the request will update to NOTIFICATION_SENT
if it sends
successfully, or to FAILED
if it fails to send.
This function requires elevated permissions and runs only on the backend and on dashboard pages.
Permission Scopes
For app development, you must have one of the following permission scopes:
Item details to use in notifications.
itemDetails may populate dynamic valyes in the notification template, as follows:
- itemDetails.name passes to the template as item.name
- itemDetails.price passes to the template as item.price
- itemDetails.image.url passes to the template as item.image.url
Use extraAutomationTemplateParameters to pass additional dynamic values.
Report options.