Set up your Performance webhook endpoint

Use a single webhook endpoint for Performance notifications and route each delivery using payload.notificationType.

Event model

Event type: SELLER_PERFORMANCE_NOTIFICATIONS
Notification type field: payload.notificationType
- ALARMS — daily shipping risks and actions
- REPORT — weekly KPI rollup across standards

Webhook endpoint design

One place to scale, monitor, and rotate secrets
Simpler subscription management
Consistent verification and idempotency rules

How to route inside your service

Inspect payload.notificationType on receipt and hand off to the correct workflow.

ALARMS → fulfillment and order operations
REPORT → analytics and account health

Always deduplicate using a delivery identifier such as eventId.

How to configure

For complete steps, use Subscribe to the performance webhook.
Include the required resource value when subscribing. Use Get event types to confirm the exact value.

API reference: Get event types, Create subscription, Update subscription, Get all subscriptions, Delete subscription.

Subscribe (recommended)

{ "events": [ { "eventType": "SELLER_PERFORMANCE_NOTIFICATIONS", "eventVersion": "V1", "resourceName": "FEEDS", "eventUrl": "https://example.com/webhooks/walmart/performance", "status": "ACTIVE" } ]
}

Recommended practices

Verify signatures and timestamps before routing.
Approved solution providers can subscribe to seller accounts who have given them access to the FEEDS scope.
Store the payload and return 2xx only after a durable write.
Keep handlers idempotent and safe to retry.
Monitor 2xx rate, retries, and signature failure rate.

Next steps

Create or update your subscriptions:
Create subscription • Update subscription • Get all subscriptions • Delete subscription
Implement verification from Security and authenticity.
Validate with Test in sandbox and review payloads in the Event catalog.

Reference guide

This guide helps you design your webhook endpoint and shows how routing and operations work for Performance notifications.

Get event types: Lists available notification event types and versions.
Create subscription: Registers your callback URL for selected events.
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.

Updated 33 minutes ago