---
updatedAt: 2026-08-03T17:25:49.000Z
---

# Updates promotional prices in bulk

<div class="amber-callout" aria-label="Migration notice"><p><strong>Migrate to Global APIs:</strong> New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore <a href ="https://developer.walmart.com/global-marketplace/docs/global-marketplace-apis" style="text-decoration: underline !important; font-weight: 700;">Global Marketplace migration resources</a>.</p></div><br> Updates or creates promotional prices for multiple specified SKUs.<b>Please download the request body sample from <a href="/file/mp/mx/promotions-feed.zip">here</a></b>

[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-2faec094-900f-4abc-92da-9edeab803683?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-2faec094-900f-4abc-92da-9edeab803683%26entityType%3Dcollection%26workspaceId%3D956a886d-5b0c-4e87-a28b-d31688fc1cc8\"\n  target=\"_blank\"\n  style=\"text-decoration: none\"\n>\n  <button>\n    <img\n      src=\"https://run.pstmn.io/button.svg\"\n      alt=\"Run In Postman\"\n      style=\"width: 128px; height: 32px\"\n    />\n  </button>\n</a>"
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "title": "Promotion Management",
    "description": "Sellers can set regular or promotional prices for their items. Setting the Promotional prices is an option to create unique pricing for events such as clearance sales or to call out a comparison price"
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false,
    "explorer-enabled": true
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Production URL"
    },
    {
      "url": "https://sandbox.walmartapis.com",
      "description": "Sandbox URL"
    }
  ],
  "security": [
    {
      "basicScheme": []
    }
  ],
  "paths": {
    "/v3/feeds": {
      "post": {
        "tags": [
          "Promotions"
        ],
        "summary": "Updates promotional prices in bulk",
        "description": "<div class=\"amber-callout\" aria-label=\"Migration notice\"><p><strong>Migrate to Global APIs:</strong> New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore <a href =\"https://developer.walmart.com/global-marketplace/docs/global-marketplace-apis\" style=\"text-decoration: underline !important; font-weight: 700;\">Global Marketplace migration resources</a>.</p></div><br> Updates or creates promotional prices for multiple specified SKUs.<b>Please download the request body sample from <a href=\"/file/mp/mx/promotions-feed.zip\">here</a></b>",
        "operationId": "updateBulkPromotionalPrice",
        "parameters": [
          {
            "name": "feedType",
            "in": "query",
            "description": "Feed Type",
            "required": true,
            "schema": {
              "type": "string",
              "default": "promo"
            }
          },
          {
            "name": "WM_MARKET",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": [
                "mx"
              ]
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "description": "Basic authorization header. Base 64 encodes the Client ID and Client Secret retrieved in step two of the integration steps.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Basic YzcyOTFjNmItNzI5MC00...."
          },
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "description": "The access token retrieved in the Token API call",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
          },
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "description": "A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "description": "A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SVC.NAME",
            "description": "Walmart Service Name",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Service Name"
          }
        ],
        "requestBody": {
          "description": "The request body consists of a Feed file attached to the request. ",
          "content": {
            "multipart/form-data": {
              "schema": {
                "required": [
                  "file"
                ],
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "description": "Feed file to upload",
                    "format": "binary"
                  }
                }
              },
              "examples": {
                "Promotional Pricing Bulk Update XML": {
                  "value": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<PriceFeed xmlns=\"http://walmart.com/\">\n    <PriceHeader>\n        <version>1.5.1</version>\n        <feedDate>2019-04-05T18:46:32.483-07:00</feedDate>\n    </PriceHeader>\n    <Price xmlns=\"http://walmart.com/\">\n        <itemIdentifier>\n            <sku>SKU-6808901249153</sku>\n        </itemIdentifier>\n        <pricingList>\n            <pricing effectiveDate=\"2023-09-09T16:10:00.943Z\" expirationDate=\"2023-09-09T16:15:00.943Z\" processMode=\"UPSERT\">\n                <currentPrice>\n                    <value currency=\"MXN\" amount=\"10.00\"/>\n                </currentPrice>\n                <currentPriceType>REDUCED</currentPriceType>\n                <comparisonPrice>\n                    <value amount=\"14.00\"/>\n                </comparisonPrice>\n            </pricing>\n        </pricingList>\n    </Price>\n    <Price xmlns=\"http://walmart.com/\">\n        <itemIdentifier>\n            <sku>SKU-6808901249245</sku>\n        </itemIdentifier>\n        <pricingList>\n            <pricing effectiveDate=\"2023-09-09T16:20:00.943Z\" expirationDate=\"2023-09-09T16:25:00.943Z\" processMode=\"UPSERT\">\n                <currentPrice>\n                    <value currency=\"MXN\" amount=\"10.00\"/>\n                </currentPrice>\n                <currentPriceType>REDUCED</currentPriceType>\n                <comparisonPrice>\n                    <value amount=\"14.00\"/>\n                </comparisonPrice>\n            </pricing>\n        </pricingList>\n    </Price>\n</PriceFeed>\n\n\n"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "feedId": {
                      "type": "string",
                      "description": "A unique identifier, which is returned by the Bulk Upload API, used to track and manage the status of the feed file."
                    },
                    "additionalAttributes": {
                      "type": "object",
                      "nullable": true
                    },
                    "errors": {
                      "type": "object",
                      "nullable": true
                    }
                  }
                },
                "example": {
                  "feedId": "C370D93A61734371AE58EB972CEF67EF@ARMBBgA"
                }
              },
              "application/xml": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "feedId": {
                      "type": "string",
                      "description": "A unique identifier, which is returned by the Bulk Upload API, used to track and manage the status of the feed file."
                    },
                    "additionalAttributes": {
                      "type": "object",
                      "nullable": true
                    },
                    "errors": {
                      "type": "object",
                      "nullable": true
                    }
                  }
                },
                "example": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<ns2:FeedAcknowledgement xmlns:ns2=\"http://walmart.com/\" xmlns:ns2_=\"v30\">\n    <ns2:feedId>E4A1D22E1BF94EE1A272A3BC72DF7BD2@ARMBBgA</ns2:feedId>\n</ns2:FeedAcknowledgement>"
              }
            }
          }
        }
      }
    }
  }
}
```