Guides
My Account

Get event types

The Event Types API allows you to retrieve a list of supported event types for webhooks, helping you stay informed about critical changes in your Walmart Marketplace account in real time. These events include updates such as item status changes, inventory adjustments, price modifications, order creation, and report status updates. By leveraging this API, you can automate workflows and respond quickly to important business events.

This API provides a comprehensive list of event types and their associated resource names, which you can subscribe to. Notifications are triggered only for the event types you choose to subscribe to, ensuring relevance and control.

  • Event Types represent workflow events that occur when a status or condition changes. Examples include:
    • An offer moving from published to unpublished status.
    • An order being auto-canceled by Walmart.
    • A change in the buy box price or winner.
  • Resource Names group similar event types into functional API categories such as Items, Prices, Orders, or Inventory. Permissions to subscribe to an event type are determined by its resource name, which maps to delegated access permissions.

Use Case Scenarios

  • Item management: Get notified when an offer is unpublished to update your catalog
  • Inventory management: Get notified when inventory is out of stock.
  • Pricing strategy: Track buy box changes to adjust pricing dynamically.
  • Order fulfillment: Receive alerts for new purchase orders or auto-cancelled lines.
  • Reporting: Monitor report status updates for analytics and compliance.

How it works

Walmart Marketplace uses webhooks to send notifications when specific events occur. This API provides a catalog of all available event types that you can subscribe to.

Each event type includes:

  • resourceName: The resource associated with the event (e.g., ITEM, ORDER).
  • eventType: The specific event identifier.
  • eventVersion: The version of the event.
  • description: A brief explanation of the event.

Endpoint

GET https://marketplace.walmartapis.com/v3/webhooks/eventTypes

Sample header

<<Authentication Headers>> Content-Type: application/json Accept: application/json Host: marketplace.walmartapis.com

Header parameter description

For authentication headers, refer to this Authentication reference article.

"data": [ {
"Name": "Content-type",
"Description": "The data format in the API payload",
"Required": "No",
"Example": "application/json"
},
{
"Name": "Accept",
"Description": "The returned data format in the response",
"Required": "Yes",
"Example": "application/json"
} ]

Sample requests

{
"resourceName": "ITEM",
"eventType": "OFFER_PUBLISHED",
"eventVersion": "V1",
"description": "Notification for published offers"
}

Modify your code

To integrate this API:

  1. Add the endpoint to your application’s API client.
  2. Ensure proper OAuth authentication as per Walmart Marketplace requirements.
  3. Parse the JSON response to display or store event types.
  4. Use the available event types when creating webhook subscriptions.

Sample response 1

{ "events": [
{
"resourceName": "ITEM",
"eventType": "OFFER_UNPUBLISHED",
"eventVersion": "V1",
"description": "Notification for unpublished offers"
}, {
"resourceName": "PRICE",
"eventType": "BUY_BOX_CHANGED",
"eventVersion": "V1",
"description": "Notification for change in buy box"
}, {
"resourceName": "ORDER",
"eventType": "PO_CREATED",
"eventVersion": "V1",
"description": "Notification for new purchase order created"
}, {
"resourceName": "ORDER",
"eventType": "PO_LINE_AUTOCANCELLED",
"eventVersion": "V1",
"description": "Notification for purchase order line auto-cancelled"
}, {
"resourceName": "REPORTS",
"eventType": "REPORT_STATUS",
"eventVersion": "V1",
"description": "Notification for report status"
}, {
"resourceName": "INVENTORY",
"eventType": "INVENTORY_OOS",
"eventVersion": "V1",
"description": "Notification for inventory out of stock"
}, { "resourceName": "ITEM", "eventType": "OFFER_PUBLISHED", "eventVersion": "V1", "description": "Notification for published offers" } ]

Sample response 2

"data": [ {
"Name": "events",
"Description": "List of events", "Type": "Array"
}, {
"Name": "eventType",
"Description": "Event that you want to subscribe to.",
"Type": "String"
},
{
"Name": "eventVersion",
"Description": "Version of the specific event type",
"Type": "String"
},
{
"Name": "resourceName",
"Description": "Delegated access scope that event type is mapped to.",
"Type": "String"
},
{
"Name": "description",
"Description": "Description of the specific event type",
"Type": "String"
} ]

Next steps

Subscribe to events: Use the event types to create webhook subscriptions via Walmart’s Webhooks Subscription API.

Updated 1 day ago