---
updatedAt: 2026-05-29T17:53:38.000Z
---
# Update reduced referral fee incentives enrollment
You can use this API endpoint to enroll any eligible item to Reduced Referral Fee incentive. You can also use this endpoint to unenroll any items from active Reduced Referral Fee incentives.
For more information and usage examples, refer to the Pricing API Guide.
[block:html]
{
"html": "\n \n"
}
[/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/feeds?feedType=INCENTIVE_ENROLLMENT": {
"post": {
"tags": [
"Prices"
],
"summary": "Update reduced referral fee incentives enrollment",
"description": "You can use this API endpoint to enroll any eligible item to Reduced Referral Fee incentive. You can also use this endpoint to unenroll any items from active Reduced Referral Fee incentives. \n\nFor more information and usage examples, refer to the Pricing API Guide.",
"operationId": "reducedReferralFeeIncentivesEnrollment",
"parameters": [
{
"name": "feedType",
"in": "query",
"description": "The feed Type for Reduced Referral Fee incentive enroll or unenroll actions.",
"required": true,
"schema": {
"type": "string",
"enum": [
"INCENTIVE_ENROLLMENT"
]
}
},
{
"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 track 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"
}
],
"requestBody": {
"description": "Submit a feed with one or more SKU-level changes to the Reduced Referral Fee incentives program. For each SKU, set `referralFeeIncentiveEnrollment` to `Y` to enroll (opt in) or `N` to unenroll (opt out).",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"ProgramActionFeedHeader": {
"type": "object",
"description": "Metadata describing the feed submission.",
"properties": {
"requestId": {
"type": "string",
"description": "Unique identifier for this feed submission (GUID recommended).",
"example": "0a90b332-1f92-40f4-afb1-92301f5d828e"
},
"requestBatchId": {
"type": "string",
"description": "Identifier for the batch of actions contained in this request. Use the same value as `requestId` for single-batch submissions.",
"example": "0a90b332-1f92-40f4-afb1-92301f5d828e"
},
"processMode": {
"type": "string",
"description": "Specifies the processing behavior for this feed. Use `REPLACE` to overwrite any previous enrollment settings for the SKUs in this feed.",
"example": "REPLACE"
},
"subset": {
"type": "string",
"description": "Indicates the data source used by the feed. Use `External` for partner-submitted feeds.",
"example": "EXTERNAL"
},
"sellingChannel": {
"type": "string",
"description": "Indicates the target sales channel.",
"example": "online"
},
"version": {
"type": "string",
"description": "Specifies the feed schema version.",
"example": "5.0.20250322-01_07_46"
},
"locale": {
"type": "string",
"description": "Locale code for the feed content.",
"example": "en"
},
"feedDate": {
"type": "string",
"format": "date-time",
"description": "The timestamp when the feed was generated, in ISO 8601 UTC format.",
"example": "2024-07-11T00:29:58Z"
},
"feedType": {
"type": "string",
"description": "The feed type for Reduced Referral Fee incentive enroll/unenroll actions. Must be `INCENTIVE_ENROLLMENT`",
"example": "INCENTIVE_ENROLLMENT"
}
}
},
"ProgramAction": {
"type": "array",
"description": "List of per-SKU enrollment updates for the Reduced Referral Fee incentives.",
"items": {
"type": "object",
"description": "An action that targets a single SKU and sets its enrollment state.",
"properties": {
"ItemIdentifiers": {
"type": "object",
"description": "Identifier(s) to the target item. ",
"properties": {
"sku": {
"type": "string",
"description": "The seller-defined SKU that uniquely identifies the item.",
"example": "SKU-121212121212"
}
}
},
"Programs": {
"type": "object",
"description": "Container for program-specific enrollment directives.",
"properties": {
"IncentivesEnrollment": {
"type": "object",
"description": "Reduced Referral Fee incentive enrollment directive for this SKU.",
"properties": {
"referralFeeIncentiveEnrollment": {
"type": "string",
"description": "Set to `Y` to enroll (opt in) this SKU in the Reduced Referral Fee incentives program, or `N` to unenroll (opt out).",
"enum": [
"Y",
"N"
],
"example": "Y"
},
"incentiveType": {
"type": "string",
"example": "The incentive program targeted by this action. For example, Reduced Referral Fee."
},
"incentiveId": {
"type": "string",
"description": "Optional program identifier used by Walmart for specific incentive campaigns. Provide if supplied; otherwise omit or set to `null`.",
"example": "d9c8b7f9-ff0c-461e-8d1f-d3064c156710",
"default": null
}
}
}
}
}
}
}
}
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"feedId": {
"type": "string",
"description": "A unique ID, returned from the Bulk Upload API, used for tracking the feed file."
},
"message": {
"type": "string",
"description": "Your items were successfully enrolled in the Reduced Referral Fee incentives."
},
"additionalAttributes": {
"type": "object",
"nullable": true
},
"errors": {
"type": "object",
"nullable": true
}
}
},
"example": {
"feedId": "14066B6642344B76A8B77AC094F8C63B@AVMBAgA",
"message": "Your items are enrolled in Reduced Referral Fee incentives. Prices will adjust to the incentive thresholds within 4 hours. These incentives will apply until their expiration, but lower prices may continue to apply afterward."
}
},
"application/xml": {
"schema": {
"type": "object",
"properties": {
"feedId": {
"type": "string",
"description": "A unique ID, returned from the Bulk Upload API, used for tracking the feed file."
},
"additionalAttributes": {
"type": "object",
"nullable": true
},
"errors": {
"type": "object",
"nullable": true
}
}
},
"example": "\n\n 55DE8A53B09F41BBBF261C1AB5FB2BC8@AVMBAgA\n Your items are enrolled in Reduced Referral Fee incentives. Prices will adjust to the incentive thresholds within 4 hours. These incentives will apply until their expiration, but lower prices may continue to apply afterward.\n "
}
}
}
}
}
}
}
}
```