---
updatedAt: 2026-05-29T17:53:38.000Z
---

# Update Walmart-funded incentives enrollment for all items

Updates the enrollment status of all items in the Walmart-funded incentives program. By default, all items are auto-enrolled in Walmart-funded incentives, meaning that eligible items are automatically included in these programs to benefit from price reductions funded by Walmart.

If you wish to permanently turn off Walmart-funded incentives for all items in your catalog, you can use this API to set the Walmart-funded incentives program status to `OFF`. The default value of this variable is `ON`. Any changes to preferences will lock in (disable) the preference option for a period of 4 hours, as indicated by the `isDisabled` response field of the API.

For more information and usage examples, refer to the <a href="https://developer.walmart.com/us-marketplace/docs/manage-enrollment-all-items-in-walmart-funded-incentives">Pricing API Guide</a>

[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-4e4731cf-b730-409e-899e-a35aeb947ccb?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-4e4731cf-b730-409e-899e-a35aeb947ccb%26entityType%3Dcollection%26workspaceId%3De352a845-5a81-4cbe-9122-9b33bac31bf3\"\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": {
    "title": "Price Management",
    "version": "1.0",
    "description": "Pricing is a fundamental building block for your listing on Walmart.com. You can use the price management APIs to set up and manage the price for a given item"
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Production URL"
    },
    {
      "url": "https://sandbox.walmartapis.com",
      "description": "Sandbox URL"
    }
  ],
  "security": [
    {
      "basicScheme": []
    }
  ],
  "paths": {
    "/v3/price/incentives/wfpreference": {
      "put": {
        "tags": [
          "Prices"
        ],
        "summary": "Update Walmart-funded incentives enrollment for all items",
        "description": "Updates the enrollment status of all items in the Walmart-funded incentives program. By default, all items are auto-enrolled in Walmart-funded incentives, meaning that eligible items are automatically included in these programs to benefit from price reductions funded by Walmart.\n\nIf you wish to permanently turn off Walmart-funded incentives for all items in your catalog, you can use this API to set the Walmart-funded incentives program status to `OFF`. The default value of this variable is `ON`. Any changes to preferences will lock in (disable) the preference option for a period of 4 hours, as indicated by the `isDisabled` response field of the API.\n\nFor more information and usage examples, refer to the <a href=\"https://developer.walmart.com/us-marketplace/docs/manage-enrollment-all-items-in-walmart-funded-incentives\">Pricing API Guide</a>",
        "operationId": "updateWalmartFundedIncentivesEnrollmentStatus",
        "parameters": [
          {
            "name": "autoEnrollEnabled",
            "in": "query",
            "description": "Specify the boolean for enabling auto enrollment. Examples of the allowed values are `true` or `false`.",
            "required": true,
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "description": "Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
          },
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "description": "A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "description": "A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SVC.NAME",
            "description": "Specifies the name of the Walmart service being called.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Marketplace"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "autoEnrollEnabled": {
                      "type": "boolean",
                      "description": "Effective global auto-enrollment setting after the update. `True` means the Walmart-funded incentives program is on for all items.",
                      "example": true
                    },
                    "isDisabled": {
                      "type": "boolean",
                      "description": "Indicates whether the preference control is locked (disabled) from further changes, typically for about 4 hours after a change.",
                      "example": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```