📘
URL: POST /api/v1/placements
| Field | Description | Type | Required | Possible Values / Notes |
|---|
| campaignId | The ID of the campaign to which the placements apply | integer | Y | A valid campaign ID |
| placements | List of placement objects to include/exclude for the campaign | array | Y | Array of objects with placement (string) and status (included / excluded) |
| Field | Description | Type | Required | Possible Values |
|---|
| placement | Name of the placement (e.g., Item Buybox, Search Carousel) | string | Y | Any placement name supported by Walmart placement feature |
| status | Whether to include or exclude the placement for the campaign | string | Y | included, `excluded |
| Header | Description |
|---|
| Authorization | Bearer <auth_token> — Bearer token used to authorize the API request. |
| accept | Recommended: application/json |
| WM_SEC.AUTH_SIGNATURE | Walmart authentication signature |
| WM_SEC.KEY_VERSION | Version of the key used to generate the signature |
| WM_CONSUMER.ID | Consumer ID issued during onboarding |
| WM_CONSUMER.intimestamp | Unix timestamp (seconds) when the request was generated |
| Content-Type | application/json (request body is JSON array of objects) |
curl -X POST \ 'https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/api/v1/placements' \ --header 'Authorization: Bearer <auth_token>' \ --header 'accept: application/json' \ --header 'Content-Type: application/json' \ --header 'WM_SEC.AUTH_SIGNATURE: **************' \ --header 'WM_SEC.KEY_VERSION: 1' \ --header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff' \ --header 'WM_CONSUMER.intimestamp: 1565309779' \ --data-raw '[ { "campaignId": 600001, "placements": [ { "placement": "Item Buybox", "status": "included" }, { "placement": "Search Carousel", "status": "excluded" } ] } ]'
| Field | Description | Type |
|---|
| code | Operation result code | string |
| details | Human-readable details (errors or success hints) | string |
| campaignId | Campaign id this response row refers to | integer |
[ { "code": "success", "details": "Placements updated successfully", "campaignId": 600001 }
]
