---
updatedAt: 2026-10-02T16:32:13.000Z
---
# Performance webhooks
Performance webhooks deliver the same performance communications that sellers receive by email to your application through HTTP POST requests. Use the webhook integration to notify your systems when a seller needs attention and to automate follow ups.
### Notification types
Performance webhook supports the following Performance notification types. Each webhook delivery includes `payload.notificationType` to indicate the notification type:
* [`ALARMS`](/us-marketplace/docs/seller-performance-alarms/) for shipping risks and actions. Notifications are triggered based on seller activity and may arrive at different times. Design your integration to process notifications as they arrive.
* [`REPORT`](/us-marketplace/docs/seller-performance-report) for the weekly KPI rollup across standards. Sent every Monday at 5:00 AM PT.
### Audience
Sellers and approved Solution Providers that integrate with Walmart Marketplace and want machine-readable Performance notifications.
## How it works
1. Discover available performance notification types. Refer to **Notification types** above and the [Event catalog](/us-marketplace/docs/event-catalog).
2. Register your webhook endpoint for Performance notifications (event: `SELLER_PERFORMANCE_NOTIFICATIONS`). Refer to [Set up your Performance webhook endpoint](/us-marketplace/docs/set-up-your-performance-webhook-endpoint).
3. Receive webhook deliveries and return 2xx on success. You'll receive `SELLER_PERFORMANCE_NOTIFICATIONS` with `payload.notificationType` set to `ALARMS` or `REPORT`. Refer to [Subscribe to the performance webhook](/us-marketplace/docs/subscribe-to-the-performance-webhook).
4. Monitor delivery retries and endpoint health. Refer to [Troubleshooting and delivery health](/us-marketplace/docs/troubleshooting-and-delivery-health/).
5. Review failure emails and logs.
## Delivery format
Webhook requests include a `payload` object with event-specific fields. Refer to the event pages for full schemas and examples. The following samples show `ALARMS` and `REPORT` payloads.
### Example: Shipping alarms (`notificationType`: "ALARMS")
```json
{
"source": {
"eventType": "SELLER_PERFORMANCE_NOTIFICATIONS",
"eventTime": "2019-02-21T01:01:08.000Z",
"eventId": "03d34580-61d4-11ea-9e23-cd38810ff7cd"
},
"payload": {
"partnerId": "123456789",
"lastRefreshTs": "2025-09-10 12:52:36 UTC",
"ordersApiUrl": "https://developer.walmart.com/",
"moreInfoLink": "https://marketplacelearn.walmart.com/guides/Policies%20&%20standards/Performance/Performance-alarms",
"supportedLanguages": [
"en-US"
],
"notificationType": "ALARMS",
"enNotification": {
"summary": "We have identified 100 orders that need your immediate attention.",
"message": "For information on all the orders, please use the following orders api",
"poNumberMaxCount": 1000,
"alarms": [
{
"alarmType": "LateOriginScan",
"orderCount": 5,
"description": "We have noticed that the above shipped orders have not been scanned by the carrier within 48 hours of the shipping confirmation being sent.",
"action": "We suggest you contact the carrier as needed to address the delays and verify your tracking information is valid for all your shipments.",
"poNumbers": [
"123",
"456"
]
},
{
"alarmType": "AutoCancelledYday",
"orderCount": 5,
"description": "We did not receive valid tracking information within 4 calendar days after the Expected Ship Date (ESD), resulting in the automatic cancellation of the above orders.",
"action": "Do not ship the above order, as the customer has already been refunded.",
"poNumbers": [
"123",
"456"
]
},
{
"alarmType": "AutoCancelledWarning",
"orderCount": 5,
"description": "We have not yet received tracking information for the above orders.",
"action": "Please upload valid tracking information today or proactively cancel the orders.",
"poNumbers": [
"123",
"456"
]
},
{
"alarmType": "ShippingDueToday",
"orderCount": 5,
"description": "We have not yet received tracking information for the above orders.",
"action": "Please upload valid tracking information today or proactively cancel the orders.",
"poNumbers": [
"123",
"456"
]
},
{
"alarmType": "UnshippedOrders",
"orderCount": 5,
"description": "We have not yet received tracking information for the above orders.",
"action": "Please upload valid tracking information today or proactively cancel the orders.",
"poNumbers": [
"123",
"456"
]
}
]
}
}
}
```
### Example: Weekly performance report (`notificationType`: "REPORT")
```json
{
"source": {
"eventType": "SELLER_PERFORMANCE_NOTIFICATIONS",
"eventFilters": null,
"eventTime": "2026-09-30T22:09:40.639Z",
"eventId": "9c7371a4-14b1-448b-a8e7-f952443797a8"
},
"payload": {
"lastRefreshTs": "2026-09-30 15:01:39 UTC",
"supportedLanguages": [
"en-US"
],
"enNotification": {
"summary": "Here is the summary of your Walmart performance, the scores are current as of Wed, Sep 30.",
"message": "To download order details use the following api links:",
"metrics": [
{
"kpi": "On-time delivery",
"score": 97.96,
"overallTrend": "RED_DOWN",
"performanceStandard": "90% or above",
"performanceRiskLevel": "Good",
"duration": "30 days",
"developerPortalApiLink": "https://developer.walmart.com/us-marketplace/reference/getotdordersreport"
},
{
"kpi": "Valid tracking",
"score": 99.45,
"overallTrend": "GREEN_UP",
"performanceStandard": "99% or above",
"performanceRiskLevel": "Good",
"duration": "30 days",
"developerPortalApiLink": "https://developer.walmart.com/us-marketplace/reference/getvtrordersreport"
},
{
"kpi": "Cancellations",
"score": 1.7,
"overallTrend": "GREEN_DOWN",
"performanceStandard": "2% or below",
"performanceRiskLevel": "Good",
"duration": "30 days",
"developerPortalApiLink": "https://developer.walmart.com/us-marketplace/reference/getcancellationsordersreport"
},
{
"kpi": "Seller response",
"score": 94.44,
"overallTrend": "GREEN_UP",
"performanceStandard": "95% or above",
"performanceRiskLevel": "Monitor",
"duration": "30 days",
"developerPortalApiLink": "https://developer.walmart.com/us-marketplace/reference/getsrrordersreport"
},
{
"kpi": "Item not received",
"score": 0.95,
"overallTrend": "NEUTRAL",
"performanceStandard": "2% or below",
"performanceRiskLevel": "Good",
"duration": "60 days",
"developerPortalApiLink": "https://developer.walmart.com/us-marketplace/reference/getinrreport"
},
{
"kpi": "Late shipment",
"score": 2.03,
"overallTrend": "NEUTRAL",
"performanceStandard": "5% or below",
"performanceRiskLevel": "Good",
"duration": "30 days",
"developerPortalApiLink": "https://developer.walmart.com/us-marketplace/reference/getlsrreport"
},
{
"kpi": "Returns",
"score": 3.02,
"overallTrend": "NEUTRAL",
"performanceStandard": "6% or below",
"performanceRiskLevel": "Good",
"duration": "60 days",
"developerPortalApiLink": "https://developer.walmart.com/us-marketplace/reference/getreturnreport",
"condTypeMetrics": [
{
"score": 3.02,
"overallTrend": "NEUTRAL",
"performanceStandard": "6% or below",
"performanceRiskLevel": "Good",
"duration": "60 days",
"developerPortalApiLink": "https://developer.walmart.com/us-marketplace/reference/getreturnreport",
"condType": "NEW"
},
{
"score": 0,
"overallTrend": "NEUTRAL",
"performanceStandard": "9% or below",
"performanceRiskLevel": "Good",
"duration": "60 days",
"developerPortalApiLink": "https://developer.walmart.com/us-marketplace/reference/getreturnreport",
"condType": "RESOLD"
}
]
}
]
},
"partnerId": "10000000140",
"notificationType": "REPORT",
"moreInfoLink": "https://marketplacelearn.walmart.com/guides/Policies%20&%20standards/Performance/Seller-performance-standards?locale=en-US"
}
}
```
### Trend values and Risk levels by KPI
* **Trend values**
Each KPI includes `overallTrend` to indicate direction versus the standard and prior period.
`GREEN_UP`, `GREEN_DOWN`, `NEUTRAL`, `RED_UP`, `RED_DOWN`. Refer to [Seller performance report](/us-marketplace/docs/seller-performance-report) for meanings and example thresholds.
* **Risk levels**
Each KPI includes `performanceRiskLevel` with one of Good, Monitor, or Urgent. Refer to [Seller performance report](/us-marketplace/docs/seller-performance-report) for meanings and example thresholds.
## When to use the performance webhook
Use the performance webhook when you want your systems to act as soon as a seller needs attention.
* You run operational workflows and want an actionable list of orders that need attention. Refer to [Seller performance alarms](/us-marketplace/docs/seller-performance-alarms/).
* Different teams own different workflows; route internally by `payload.notificationType` at your webhook endpoint. Refer to [Set up your Performance webhook endpoint](/us-marketplace/docs/set-up-your-performance-webhook-endpoint).
* You are an approved solution provider and want one consistent feed for all your sellers. Start with [Subscribe to the performance webhook](/us-marketplace/docs/subscribe-to-the-performance-webhook).
## Prerequisites
* A Walmart Marketplace seller or partner account
* Production or sandbox API credentials
* A public HTTPS callback URL that returns 2xx on success
* A webhook endpoint for Performance notifications. Refer to [Set up your Performance webhook endpoint](/us-marketplace/docs/set-up-your-performance-webhook-endpoint). The `resource` value when subscribing is `FEEDS`.
## Implementation path
1. **Set up your Performance webhook endpoint**
Configure your webhook endpoint to receive Performance notifications and route internally using `payload.notificationType`. Refer to [Set up your Performance webhook endpoint](/us-marketplace/docs/set-up-your-performance-webhook-endpoint).
2. **Subscribe to Performance notifications**
Review the available event types and create one or more subscriptions using your callback URL. Include `FEEDS` as the `resource` value. Refer to [Subscribe to the performance webhook](/us-marketplace/docs/subscribe-to-the-performance-webhook).
**API reference**: [Get event types](https://developer.walmart.com/us-marketplace/reference/geteventtypes), [Create subscription](https://developer.walmart.com/us-marketplace/reference/createsubscription), [Update subscription](https://developer.walmart.com/us-marketplace/reference/updatesubscription), [Get all subscriptions](https://developer.walmart.com/us-marketplace/reference/getallsubscriptions), [Delete subscription](https://developer.walmart.com/us-marketplace/reference/deletesubscription).
3. **Handle and acknowledge events**
Store the payload, deduplicate using the delivery identifier exposed to integrators (for example, a top-level `eventId` field or a documented delivery header), start your workflows, and return 2xx after a durable write. Refer to the [Event catalog](/us-marketplace/docs/event-catalog) for payload shapes and examples.
4. **Monitor delivery health**
Review logs, watch for retries, and fix failing endpoints. Walmart retries on non-2xx. Refer to [Troubleshooting and delivery health](/us-marketplace/docs/troubleshooting-and-delivery-health/).
5. **Test in sandbox**
Send a test delivery to validate your routing and acknowledgment behavior. Refer to [Test in sandbox](/us-marketplace/docs/test-in-sandbox/).
**API reference**: [Test notification](https://developer.walmart.com/us-marketplace/reference/testnotification).
## Delivery health and retries
* Walmart retries when your endpoint does not return 2xx. Refer to [Troubleshooting and delivery health](/us-marketplace/docs/troubleshooting-and-delivery-health/).
* Log deliveries and failures and deduplicate using the delivery identifier you store.
## Market availability
The performance webhook is available for sellers listing on Walmart marketplaces in the United States.
## Reference guide
This guide explains how to use the performance webhook in your integration, with concepts, setup steps, and payload examples.
* [Get event types](https://developer.walmart.com/us-marketplace/reference/geteventtypes): Lists available notification event types and versions.
* [Create subscription](https://developer.walmart.com/us-marketplace/reference/createsubscription): Registers your callback URL for selected events. Requires the `resource` value.
* [Update subscription](https://developer.walmart.com/us-marketplace/reference/updatesubscription): Changes an existing subscription (endpoint URL, event set, or status).
* [Get all subscriptions](https://developer.walmart.com/us-marketplace/reference/getallsubscriptions): Returns all subscriptions on your account for auditing and troubleshooting.
* [Delete subscription](https://developer.walmart.com/us-marketplace/reference/deletesubscription): Removes a subscription you no longer need.
* [Test notification](https://developer.walmart.com/us-marketplace/reference/testnotification): Triggers a sample delivery to your callback URL to validate your integration.
## Event catalog
Refer to the full catalog: [Event catalog](/us-marketplace/docs/event-catalog)
Quick links:
* [Seller performance alarms](/us-marketplace/docs/seller-performance-alarms/)
* [Seller performance report](/us-marketplace/docs/seller-performance-report)
## Next steps
* Read [Set up your Performance webhook endpoint](/us-marketplace/docs/set-up-your-performance-webhook-endpoint).
* Follow [Subscribe to the performance webhook](/us-marketplace/docs/subscribe-to-the-performance-webhook) to create your subscriptions.
* Use [Test in sandbox](/us-marketplace/docs/test-in-sandbox/) to validate deliveries and your acknowledgment behavior.