Test Notification API

Use the Test Notification API to validate that your webhook endpoint can receive Walmart Marketplace event callbacks. It sends a lightweight test event (for example, OFFER_UNPUBLISHED) to your eventUrl using the auth method you specify, and returns a simple confirmation when the callback succeeds.

How it works

1. Call POST /v3/webhooks/test with your event details and eventUrl.
2. Walmart attempts to POST a test payload to your eventUrl with the provided authDetails and headers.
3. If your endpoint returns a successful status (200), the API responds with a confirmation message indicating the test passed.

Endpoint

POST <https://marketplace.walmartapis.com/v3/webhooks/test>

Sample request

curl --request POST \ --url https://marketplace.walmartapis.com/v3/webhooks/test \ --header 'accept: application/json' \ --header 'content-type: application/json'

import requests url = "https://marketplace.walmartapis.com/v3/webhooks/test"
headers = { "accept": "application/json", "content-type": "application/json"
} response = requests.post(url, headers=headers) print("Status code:", response.status_code)
try: print("Response JSON:", response.json())
except Exception: print("Response Text:", response.text)

Modify your code

Update the placeholders in the sample cURL before you call POST /v3/webhooks/test.

1. Set headers and add the OAuth 2.0 bearer token in the Authorization header of your request.
2. Provide your webhook details (recommended): Include a JSON body so Walmart knows where and how to deliver the test.

{ "eventType": "OFFER_UNPUBLISHED", "eventVersion": "V1", "resourceName": "ITEM", "eventUrl": "https://your-domain.example/webhooks/walmart", "authDetails": { "authMethod": "BASIC_AUTH", "authHeaderName": "Authorization", "userName": "<USERNAME>", "password": "<PASSWORD>" }, "headers": { "content-type": "application/json" }
}

3. eventUrl, eventType, eventVersion, resourceName: The provided values are valid for testing. Adjust if you need to simulate a different event your integration supports.
4. Make the JSON valid: Remove escape characters and angle brackets, use straight quotes, and avoid trailing commas.

Sample response

{ "message": "Eventurl successfully validated" }