Performance webhooks

Performance webhooks deliver the same performance communications that sellers receive by email to your application through HTTP POST requests. Use them to notify your systems when a seller needs attention and to automate follow ups.

Event types

All performance notifications are delivered as a single master event: SELLER_PERFORMANCE_NOTIFICATIONS. The payload.notificationType distinguishes the notification :

• ALARMS for daily shipping risks and actions. Sent at 6:00 AM PT.
• 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 event types. See Event types above and the Event catalog.
2. Register a unified endpoint for the SELLER_PERFORMANCE_NOTIFICATIONS event type and event variants. Refer to Set up your Performance webhooks endpoints.
3. Verify delivery authenticity before you process payloads. See Security and authenticity.
4. Receive events and return 2xx on success. You'll receive SELLER_PERFORMANCE_NOTIFICATIONSwith payload.notificationType set to ALARMS or REPORT. See Subscribe to performance webhooks.
5. Monitor retries and delivery health. Refer to Troubleshooting and delivery health.
6. Review logs.

Delivery format

Webhook requests include a payload object with event-specific fields. See the event pages for full schemas and examples. The following samples reflect the daily alarms and weekly report payloads.

Example: Daily shipping alarms (notificationType: "ALARMS")

{ "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")

{ "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", "moreInfoLink": "https://marketplacelearn.walmart.com/guides/Policies%20&%20standards/Performance/Seller-performance-standards?locale=en-US", "supportedLanguages": ["en-US"], "notificationType": "REPORT", "enNotification" : { "summary" : "Here is the summary of your Walmart performance, the scores are current as of Sun Jul 27", "message" : "To download order details use the following api links:", "metrics": [ { "kpi": "On-time delivery", "score": 75.8, "overallTrend" : "GREEN_UP", "performanceStandard": "90% or above", "performanceRiskLevel" : "Monitor", "duration" : "30 days", "developerPortalApiLink" : "https://developer.walmart.com/us-marketplace/reference/getotdordersreport" }, { "kpi": "Valid tracking", "score": 75.8, "overallTrend" : "GREEN_UP", "performanceStandard": "99% or above", "performanceRiskLevel" : "Monitor", "duration" : "30 days", "developerPortalApiLink" : "https://developer.walmart.com/us-marketplace/reference/getvtrordersreport" }, { "kpi": "Seller response", "score": 75.8, "overallTrend" : "GREEN_UP", "performanceStandard": "95% or above", "performanceRiskLevel" : "Monitor", "duration" : "30 days", "developerPortalApiLink" : "https://developer.walmart.com/us-marketplace/reference/getsrrordersreport" }, { "kpi": "Refunds", "score": 2.8, "overallTrend" : "GREEN_DOWN", "performanceStandard": "6% or below", "performanceRiskLevel" : "Monitor", "duration" : "30 days", "developerPortalApiLink" : "https://developer.walmart.com/us-marketplace/reference/getcancellationsordersreport" }, { "kpi": "Cancellations", "score": 5.8, "overallTrend" : "GREEN_DOWN", "performanceStandard": "2% or below", "performanceRiskLevel" : "Urgent", "duration" : "30 days", "developerPortalApiLink" : "https://developer.walmart.com/us-marketplace/reference/getrefundsordersreport" } ] } }
}

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 for meanings and example thresholds.
• Risk levels
  Each KPI includes performanceRiskLevel with one of Good, Monitor, or Urgent. Refer to Seller performance report for meanings and example thresholds.

When to use performance webhooks

Use performance webhooks when you want your systems to act as soon as a seller needs attention.

• You run an operations job each morning and want an actionable list of orders today. Refer Seller performance alarms.
• Different teams own different workflows; route internally by payload.notificationType at your unified endpoint. Refer to Set up your Performance webhooks endpoints.
• You are an approved solution provider and want one consistent feed for all your sellers. Start with Subscribe to performance webhooks.

Prerequisites

• A Walmart Marketplace seller or partner account
• Production or sandbox API credentials
• A public HTTPS callback URL that returns 2xx on success
• A single unified endpoint for all Performance notifications. Refer to Set up your Performance webhooks endpoints. The resource value when subscribing is FEEDS.

Implementation path

1. Set up your Performance webhooks endpoint
   Use a single unified endpoint for all Performance notifications and route internally by payload.notificationType. Refer to Set up your Performance webhooks endpoints.

2. Subscribe
   Discover event types, then create one or more subscriptions with your callback URL. Include the required resourcevalueFEEDS when subscribing. See Subscribe to performance webhooks.
   API reference: Get event types, Create subscription, Update subscription, Get all subscriptions, Delete subscription.

3. Secure delivery
   Verify request signatures and confirm that each event targets a seller you manage. Reject any request that fails verification. See Security and authenticity.

4. 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. See the Event catalog for payload shapes and examples.

5. Monitor delivery health
   Review logs, watch for retries, and fix failing endpoints. Walmart retries on non-2xx. See Troubleshooting and delivery health.

6. Test in sandbox
   Send a test delivery to validate your routing, signature checks, and acknowledgment behavior. See Test in sandbox.
   API reference: Test notification.

Delivery health and retries

• Walmart retries when your endpoint does not return 2xx. See Troubleshooting and delivery health.
• Log deliveries and failures and deduplicate using the delivery identifier you store.

Market availability

These webhooks are available for sellers listing on Walmart marketplaces in the United States.

Reference guide

This guide explains how to use performance webhooks in your integration, with concepts, setup steps, and payload examples.

• Get event types: Lists available notification event types and versions.
• Create subscription: Registers your callback URL for selected events. Requires the resource value.
• Update subscription: Changes an existing subscription (endpoint URL, event set, or status).
• Get all subscriptions: Returns all subscriptions on your account for auditing and troubleshooting.
• Delete subscription: Removes a subscription you no longer need.
• Test notification: Triggers a sample delivery to your callback URL to validate your integration.

Event catalog

See the full catalog: Event catalog

Quick links:

• Seller performance alarms
• Seller performance report

Next steps

• Read Set up your Performance webhooks endpoints.
• Follow Subscribe to performance webhooks to create your subscriptions.
• Implement signature verification from Security and authenticity.
• Use Test in sandbox to validate deliveries and your acknowledgment behavior.