---
updatedAt: 2026-06-25T22:00:33.000Z
---

# 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

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

## Sample request

```curl cURL
curl --request POST \
     --url https://marketplace.walmartapis.com/v3/webhooks/test \
     --header 'accept: application/json' \
     --header 'content-type: application/json'
```
```python
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.

```Text JSON
curl --request POST \
     --url https://marketplace.walmartapis.com/v3/webhooks/test \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
       "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": {
         "X-Custom-Header": "my-value"
       }
     }'
```

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

```Text JSON
{  
  "message": "Eventurl successfully validated"  
}
```

<br />