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 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 notification types. Refer to Notification types above and the Event catalog.
2. Register your webhook endpoint for Performance notifications (event: SELLER_PERFORMANCE_NOTIFICATIONS). Refer to Set up your Performance webhook endpoint.
3. Verify delivery authenticity before you process payloads. Refer to Security and authenticity.
4. 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.
5. Monitor delivery retries and endpoint health. Refer to Troubleshooting and delivery health.
6. Review 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 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 the performance webhook

Use the performance webhook 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 webhook endpoint. Refer to 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.

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. 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.

2. Subscribe
   Discover event types, then create one or more subscriptions with your callback URL. Include the required resource value FEEDS when subscribing. Refer to Subscribe to the performance webhook.
   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. Refer to 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. Refer to 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. Refer to Troubleshooting and delivery health.

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

Delivery health and retries

• Walmart retries when your endpoint does not return 2xx. Refer to 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: 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

Refer to the full catalog: Event catalog

Quick links:

• Seller performance alarms
• Seller performance report

Next steps

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