Webhook message schema

What an HTTPS webhook receives, field by field. The same is published as a JSON Schema (draft 2020-12) at sellersheetai.com/schemas/webhooks-v1.json, with one sample delivery per notification at sellersheetai.com/schemas/webhooks-v1-samples.json. Every value on this page is made up.

Rules that hold everywhere:

• Keys are camelCase, except inside amazon, which keeps Amazon's own spelling.
• Every key is always sent. "Required" below is what the schema requires; a key that is not required is sent as null (or [], {}) when it has no value.
• Objects are not closed: a key you do not know may appear later within schemaVersion 1 — ignore it.
• Times are ISO 8601 date-times in UTC (2026-10-27T09:28:33Z), except inside amazon, which keeps Amazon's text.

HeadersCopy Anchor Link

The deliveryCopy Anchor Link

The body of one request: up to 100 messages, at most 1 MB.

A messageCopy Anchor Link

One Amazon notification.

storeCopy Anchor Link

amazonCopy Anchor Link

Amazon's notification — the source of truth. The top-level names are fixed; every value is exactly what Amazon sent, in Amazon's own casing (PascalCase for some notifications, camelCase for others): read a key in either casing.

The payload of each notification is documented by Amazon in the Selling Partner API's notification type reference.

summaryCopy Anchor Link

Every summary has these four fields:

Then the fields of its messageType, below, in the order of the Webhooks page. A type this page does not list carries the four fields only. A full sample delivery of each type, valid against the schema: webhooks-v1-samples.json.

Listing issuesCopy Anchor Link

LISTINGS_ITEM_ISSUES_CHANGE — the issues now in force on a listing. Amazon never sends the issue text: open the SKU in Seller Central to read it.

{
  "text": "SKU SKU-EXAMPLE-01 (B0EXAMPLE01) on US: Listing not buyable (suppressed) · Severities=ERROR · EnforcementActions=LISTING_SUPPRESSED",
  "severity": "critical",
  "sku": "SKU-EXAMPLE-01",
  "asin": "B0EXAMPLE01",
  "severities": ["ERROR"],
  "enforcementActions": ["LISTING_SUPPRESSED"],
  "cleared": false
}

Listing statusCopy Anchor Link

LISTINGS_ITEM_STATUS_CHANGE — the listing's current status set. A status that is missing is its opposite: no BUYABLE means not buyable, no DISCOVERABLE means not in search results.

{
  "text": "SKU SKU-EXAMPLE-02 (B0EXAMPLE02) on US: Buyable · Status=BUYABLE,DISCOVERABLE",
  "severity": "recovery",
  "sku": "SKU-EXAMPLE-02",
  "asin": "B0EXAMPLE02",
  "status": ["BUYABLE", "DISCOVERABLE"],
  "buyable": true,
  "discoverable": true,
  "deleted": false
}

Brand contentCopy Anchor Link

BRANDED_ITEM_CONTENT_CHANGE — which attributes of a catalog item of your brand changed. No SKU. Amazon sends one copy per brand-owner store the webhook takes.

{
  "text": "ASIN B0EXAMPLE04 on US: Changed: item_name, bullet_point · AttributesChanged=item_name,bullet_point · BrandName=MyBrand",
  "severity": "info",
  "sku": null,
  "asin": "B0EXAMPLE04",
  "brandName": "MyBrand",
  "attributesChanged": ["item_name", "bullet_point"]
}

Product type changeCopy Anchor Link

ITEM_PRODUCT_TYPE_CHANGE — an ASIN's product type, before and now. What its listings must say may have changed with it. No SKU.

Self-fulfilled quantityCopy Anchor Link

LISTINGS_ITEM_MFN_QUANTITY_CHANGE — a SKU's self-fulfilled quantity now. No ASIN, and no marketplace: the quantity is the seller account's.

Product type definitionsCopy Anchor Link

PRODUCT_TYPE_DEFINITIONS_CHANGE — a new version of a marketplace's product type definitions. No SKU or ASIN. Amazon sends one copy per store the webhook takes.

Pricing healthCopy Anchor Link

PRICING_HEALTH — why your offer cannot be the featured offer, against Amazon's reference prices. No SKU: Amazon sends the ASIN only.

{
  "text": "ASIN B0EXAMPLE03 on US: Not eligible for the featured offer · issueType=BuyBoxDisqualification · yours 29.99 USD, FBA (fulfillmentType=AFN) · competitivePriceThreshold=24.99 USD · averageSellingPrice=26.50 USD",
  "severity": "warning",
  "sku": null,
  "asin": "B0EXAMPLE03",
  "issueType": "BuyBoxDisqualification",
  "yourPrice": { "amount": 29.99, "currencyCode": "USD" },
  "fulfillmentType": "AFN",
  "competitivePriceThreshold": { "amount": 24.99, "currencyCode": "USD" },
  "referencePrices": {
    "competitivePriceThreshold": { "amount": 24.99, "currencyCode": "USD" },
    "averageSellingPrice": { "amount": 26.5, "currencyCode": "USD" }
  }
}

Competing offersCopy Anchor Link

ANY_OFFER_CHANGED — the Buy Box, your offer and up to five other sellers' offers on an ASIN another seller is on. Amazon gives seller IDs, never names, and no SKU.

{
  "text": "ASIN B0EXAMPLE05 on US: 1 other seller: A2EXAMPLEOTHER 19.99 USD FBM, Buy Box, 95% of 120 · you 21.49 USD FBA, 99% of 812 · OfferChangeType=External · BuyBoxPrice=19.99 USD · NumberOfOffers=new Merchant 1,new Amazon 1",
  "severity": "warning",
  "sku": null,
  "asin": "B0EXAMPLE05",
  "changeType": "External",
  "buyBox": {
    "price": { "amount": 19.99, "currencyCode": "USD" },
    "sellerId": "A2EXAMPLEOTHER",
    "isYours": false
  },
  "yourOffer": {
    "sellerId": "A1EXAMPLESELLER",
    "price": { "amount": 21.49, "currencyCode": "USD" },
    "shipping": { "amount": 0.0, "currencyCode": "USD" },
    "fulfillment": "FBA",
    "isBuyBoxWinner": false,
    "feedbackRating": 99,
    "feedbackCount": 812
  },
  "competitors": [
    {
      "sellerId": "A2EXAMPLEOTHER",
      "price": { "amount": 19.99, "currencyCode": "USD" },
      "shipping": { "amount": 0.0, "currencyCode": "USD" },
      "fulfillment": "FBM",
      "isBuyBoxWinner": true,
      "feedbackRating": 95,
      "feedbackCount": 120
    }
  ],
  "numberOfOffers": 2,
  "sellersChanged": true,
  "buyBoxWinnerChanged": true
}

Business offers (B2B)Copy Anchor Link

B2B_ANY_OFFER_CHANGED — as Competing offers, over the business (B2B) offers on the ASIN. No changeType, sellersChanged or buyBoxWinnerChanged.

Fee promotionsCopy Anchor Link

FEE_PROMOTION — a fee promotion Amazon offers you: what it is, when it runs, and its first discount. sku or asin is set when it names exactly one item.

Order changesCopy Anchor Link

ORDER_CHANGE — the order's status now and what changed. sku is set when the order holds one SKU.

Multi-Channel Fulfillment ordersCopy Anchor Link

FULFILLMENT_ORDER_STATUS — a Multi-Channel Fulfillment order, its packages and tracking. Amazon names no marketplace. sku is set when the order holds one SKU.

FBA Onsite shipments (Brazil)Copy Anchor Link

FBA_OUTBOUND_SHIPMENT_STATUS — a shipment Amazon created or cancelled for an order. Brazil only.

External fulfillment shipmentsCopy Anchor Link

EXTERNAL_FULFILLMENT_SHIPMENT_STATUS_CHANGE — a shipment of your own fulfillment location changed status. Amazon names no marketplace.

FBA inventoryCopy Anchor Link

FBA_INVENTORY_AVAILABILITY_CHANGES — a SKU's FBA quantities, summed over every marketplace Amazon lists, and per marketplace. The message's marketplace is the first one listed.

Hourly inventoryCopy Anchor Link

ITEM_INVENTORY_EVENT_CHANGE — one hour's highly available inventory, summed over every ASIN Amazon lists. asin is set when it lists one.

Hourly salesCopy Anchor Link

ITEM_SALES_EVENT_CHANGE — one hour's ordered units and revenue, summed over every ASIN Amazon lists. asin is set when it lists one.

Hourly page viewsCopy Anchor Link

DETAIL_PAGE_TRAFFIC_EVENT — one hour's detail page views, summed over every ASIN Amazon lists. asin is set when it lists one.

TransactionsCopy Anchor Link

TRANSACTION_UPDATE — a transaction posted to your account.

Account healthCopy Anchor Link

ACCOUNT_STATUS_CHANGED — the seller account's status. No item; the message's store is your store in its first marketplace.

{
  "text": "Account at risk · PreviousAccountStatus=NORMAL · CurrentAccountStatus=AT_RISK",
  "severity": "warning",
  "sku": null,
  "asin": null,
  "previousStatus": "NORMAL",
  "currentStatus": "AT_RISK"
}

Report finishedCopy Anchor Link

REPORT_PROCESSING_FINISHED — a report request finished. It includes the reports SellerSheet requests to keep your store's data in sync. Amazon names no marketplace.

Feed finishedCopy Anchor Link

FEED_PROCESSING_FINISHED — a feed finished. Amazon names no marketplace.

Data Kiosk query finishedCopy Anchor Link

DATA_KIOSK_QUERY_PROCESSING_FINISHED — a Data Kiosk query finished. Amazon names no marketplace.

ObjectsCopy Anchor Link

moneyCopy Anchor Link

offerCopy Anchor Link

buy boxCopy Anchor Link

packageCopy Anchor Link

marketplace inventoryCopy Anchor Link

ValidatingCopy Anchor Link

Any JSON Schema draft 2020-12 validator can check a body against webhooks-v1.json. The schema types summary by messageType (one "if messageType is this type, then summary is this shape" rule per notification), so a validator checks each message's summary against its own type.