New FIFO cost of goods is here (beta, US marketplace): cost every sale from your actual purchase lots. See how it works
Developer

Webhook Alerts

Send SellerLegend alerts such as Buy Box loss, suppressed listings and low inventory straight to your own systems as signed JSON webhooks, so your team chat, helpdesk or internal tools can act on them as soon as they are raised.

Developer New
POST https://hooks.example.com/sellerlegend
X-SellerLegend-Event: sl.loss_of_buybox
X-SellerLegend-Signature: t=1791969600,v1=5f2b…c9e1
{
  "event_id": "evt_8c1f…",
  "event_type": "sl.loss_of_buybox",
  "emitted_at": "2026-10-14T09:20:00+00:00",
  "account": { "marketplace": "ATVPDKIKX0DER", "currency": "USD" },
  "notification_type": "Loss Of Buybox",
  "data": { … }
}
200 OK · delivered on attempt 1

Overview

Webhook Alerts let SellerLegend send the alerts you already receive in the app and by email to a web address that you or your developer control. When SellerLegend raises an alert, such as a lost Buy Box, a listing change, a suppressed listing, low inventory, a return or a failed Amazon connection, it sends an HTTPS POST with a JSON body to every endpoint attached to that rule. From there you can post it into team chat, open a helpdesk ticket, update an internal dashboard or start any workflow you build. Setup takes a few minutes in Account Settings → Notifications: add an endpoint with a label and an https:// address on the Destinations tab, copy its signing secret, then tick Webhook on any notification rule and choose the endpoint. Every alert type can be sent by webhook, and each rule lets you choose which accounts it covers. Each delivery carries a stable event type such as sl.loss_of_buybox, a unique event ID, the account and marketplace it came from, and the alert details. Every request is signed with HMAC-SHA256 using a secret unique to that endpoint, with a timestamp, so your receiver can confirm it came from SellerLegend and reject replayed requests. Secrets can be rotated at any time. If your endpoint is down, SellerLegend makes up to five delivery attempts over roughly two and a half hours, honours Retry-After on a 429 response, and keeps the same event ID on every retry so you can ignore duplicates. Endpoints that keep failing, or that miss all five attempts for one delivery, are paused automatically and can be re-enabled from the Destinations tab once fixed. You can add up to 25 endpoints, and your existing in-app and email alerts keep working exactly as before. Public documentation with the full payload format and signature verification examples in Node.js, Python and PHP is available at docs.sellerlegend.com.

At a Glance

All Types Alert Types Covered
HMAC-SHA256 Signed Deliveries
5 Attempts Automatic Retries
25 Endpoints per Account

Perfect For

Developers Tech Teams Operations Teams Agencies

Key Benefits

Every Alert Type

Send Buy Box loss, listing changes, suppressed listings, inventory, back-in-stock, returns, feedback, restock suggestions, watchlisted customer orders, excessive order quantities, import/export reports, charge invoice downloads and Amazon connection failures by webhook

Signed Deliveries

Every request is signed with HMAC-SHA256 using a secret unique to each endpoint, with a timestamp so your receiver can reject replays

Automatic Retries

Up to five attempts over about two and a half hours, Retry-After honoured on 429 responses, and the same event ID on every retry for easy de-duplication

Rules You Control

Choose which alerts and which accounts go to which endpoint, alongside your existing in-app and email alerts

Self-Protecting Endpoints

Endpoints that keep failing, or miss all five attempts for one delivery, are paused automatically, and you can re-enable them from the Destinations tab once fixed

Developer-Ready Docs

Public docs with the full payload format and signature verification examples in Node.js, Python and PHP

Want to see it in action?

See this in the live demo

What's Included

HTTPS POST with a JSON body
Works with every notification type
Up to 25 endpoints per account
Per-endpoint signing secret
HMAC-SHA256 signature with timestamp
Signing secret rotation
Stable event types (e.g. sl.loss_of_buybox)
Unique event ID, the same on every retry
Account, seller ID, marketplace and currency in every payload
Up to 5 delivery attempts over about 2.5 hours
Retry-After honoured on 429 responses
Automatic pause for failing endpoints
Re-enable from the Destinations tab
Per-rule account selection
Runs alongside in-app and email alerts
Public docs with Node.js, Python and PHP examples

Ready to Get Started with Webhook Alerts?

Join thousands of successful Amazon sellers using SellerLegend to grow their business.

Start Your 21-Day Free Trial

No Credit Card Required • Access All Features • Cancel Anytime

Ready to boost your Amazon profits? 21-day free trial • No credit card required