Skip to main content

PUT/item_price_markdown/{promotion_id}

This method updates the specified item price markdown promotion with the new configuration that you supply in the payload of the request. Specify the promotion you want to update using the promotion_id path parameter. Call getPromotions to retrieve the IDs of a seller's promotions.

When updating a promotion, supply all the fields that you used to configure the original promotion (and not just the fields you are updating). eBay replaces the specified promotion with the values you supply in the update request and if you don't pass a field that currently has a value, the update request fails.

The parameters you are allowed to update with this request depend on the status of the promotion you're updating:

  • DRAFT or SCHEDULED promotions: You can update any of the parameters in these promotions that have not yet started to run, including the discountRules.
  • RUNNING promotions: You can change the endDate and the item's inventory but you cannot change the promotional discount or the promotion's start date.
  • ENDED promotions: Nothing can be changed.

Input

Resource URI

PUT https://api.ebay.com/sell/marketing/v1/item_price_markdown/{promotion_id}

This method is supported in Sandbox environment. To access the endpoint, just replace the api.ebay.com root URI with api.sandbox.ebay.com

URI parameters

ParameterTypeDescription
promotion_idstringThis path parameter takes a concatenation of the ID of the promotion you want to update plus the marketplace ID on which the promotion is hosted. Concatenate the two values by separating them with an "at sign" (@).

The ID of the promotion (promotionId) is a unique eBay-assigned value that's generated when the promotion is created. The Marketplace ID is the ENUM value of eBay marketplace where the promotion is hosted.

Use the getPromotions method to retrieve promotion Ids. See MarketplaceIdEnum for supported Marketplace ID values.

Example: 1********5@EBAY_US

Occurrence: Required

HTTP request headers

All requests made to eBay REST operations require you to provide the Authorization HTTP header for authentication authorization.

The table below shows additional HTTP request headers that are either required, conditionally required, or strongly recommended for this method. Other standard HTTP request headers- opens rest request components page (not in this table) can also be used, but they are optional.

HeaderTypeDescription
Content-TypestringThis header indicates the format of the request body provided by the client. Its value should be set to application/json.

For more information, refer to HTTP request headers.

Occurrence: Required

OAuth scope

This request requires an access token created with the client credentials grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):

https://api.ebay.com/oauth/api_scope/sell.marketing

See OAuth access tokens for more information.

Request payload

Copy complete valid JSON to clipboard
{ /* ItemPriceMarkdown */
"name" : "string",
"selectedInventoryDiscounts" : [
{ /* SelectedInventoryDiscount */ }
],
}

Request fields

Input container/fieldTypeDescription
applyFreeShippingboolean

If set to true, free shipping is applied to the first shipping service specified for the item. The first domestic shipping option is set to "free shipping," regardless if the shipping optionType for that service is set to FLAT_RATE, CALCULATED, or NOT_SPECIFIED (freight). This flag essentially adds free shipping as a promotional bonus.

Default: false

Occurrence: Optional

autoSelectFutureInventoryboolean

If set to true, eBay will automatically add inventory items to the markdown promotion if they meet the selectedInventoryDiscounts criteria specified for the markdown promotion.

Default: false

Occurrence: Optional

blockPriceIncreaseInItemRevisionboolean

If set to true, price increases (including removing the free shipping flag) are blocked and an error message is returned if a seller attempts to adjust the price of an item that's partaking in this markdown promotion. If set to false, an item is dropped from the markdown promotion if the seller adjusts the price.

Default: false

Occurrence: Optional

descriptionstring

This field is required if you are configuring an MARKDOWN_SALE promotion.

This is the seller-defined "tag line" for the offer, such as "Save on designer shoes." A tag line appears under the "offer-type text" that is generated for the promotion. The text is displayed on the offer tile that is shown on the seller's All Offers page and on the event page for the promotion.

Note: Offer-type text is a teaser that's presented throughout the buyer's journey through the sales flow and is generated by eBay. This text is not editable by the seller—it's derived from the settings in the discountRules and discountSpecification fields—and can be, for example, "20% off".


Maximum length: 50

Occurrence: Required

endDatestring

The date and time the promotion ends, in UTC format (yyyy-MM-ddThh:mm:ssZ). The value supplied for endDate must be at least 24 hours after the value supplied for the startDate of the markdown promotion.

For display purposes, convert this time into the local time of the seller.

Max value:

  • 14 days for the AT, CH, DE, ES, FR, IE, IT, and UK, marketplaces.
  • 45 days for all other marketplaces.

Occurrence: Required

marketplaceIdMarketplaceIdEnum

The eBay marketplace ID of the site where the markdown promotion is hosted. Markdown promotions are supported on all eBay marketplaces.

Occurrence: Required

namestring

The seller-defined name or 'title' of the promotion that the seller can use to identify a promotion. This label is not displayed in end-user flows.

Maximum length: 90

Occurrence: Required

priorityPromotionPriorityEnum

This field is ignored in markdown promotions.

Occurrence: Optional

promotionImageUrlstring

Required for CODED_COUPON, MARKDOWN_SALE, and ORDER_DISCOUNT promotions, populate this field with a URL that points to an image to be used with the promotion. This image is displayed on the seller's All Offers page. The URL must point to either JPEG or PNG image and it must be a minimum of 500x500 pixels in dimension and cannot exceed 12Mb in size.

Occurrence: Conditional

promotionStatusPromotionStatusEnum

The current status of the promotion. When creating a new promotion, you must set this value to either DRAFT or SCHEDULED.

Note that you must set this value to SCHEDULED when you update a RUNNING promotion.

Occurrence: Required

selectedInventoryDiscountsarray of SelectedInventoryDiscount

A list that defines the sets of selected items for the markdown promotion and the discount specified for promotion.

Occurrence: Required

selectedInventoryDiscounts.discountBenefitDiscountBenefit

This container defines the promotional discount as either a monetary amount or a percentage applied to the sales price.

Occurrence: Required

selectedInventoryDiscounts.discountBenefit.amountOffItemAmount

The monetary amount that is discounted off an item (or items) when the promotion criteria is met.

For threshold promotions, where the buyer triggers the discount, the valid values for this field are:
  5, 6, 7, 8, 9, 10, 15, 20, 25,
  30, 35, 40, 45, 50, 55, 60, 65,
  70, 75, 80, 85, 90, 95, 100, 110,
  120, 125, 150, 200, 250


For markdown promotions, the range is greater, as outlined below and detailed more precisely here:

  • $1 increments from $5 to $100
  • $5 increments from $105 to $1,000
  • $100 increments from $1,100 to $15,000

Occurrence: Optional

selectedInventoryDiscounts.discountBenefit.amountOffItem.currencyCurrencyCodeEnum

The base currency applied to the value field to establish a monetary amount.

The currency is represented as a 3-letter ISO 4217 currency code. For example, the code for the Canadian Dollar is CAD.

Default: The default currency of the eBay marketplace that hosts the listing.

Occurrence: Conditional

selectedInventoryDiscounts.discountBenefit.amountOffItem.valuestring

The monetary amount in the specified currency.

Required in the amount type.

Occurrence: Conditional

selectedInventoryDiscounts.discountBenefit.amountOffOrderAmount

Used for threshold promotions, this is the monetary amount that is discounted off an order when the promotion criteria is met. Because this field is valid only for orders, it's not a valid combination to use with markdown promotions.

Valid values for the associated amountOffOrder.value field:
  5, 6, 7, 8, 9, 10, 15, 20, 25,
  30, 35, 40, 45, 50, 55, 60, 65,
  70, 75, 80, 85, 90, 95, 100, 110,
  120, 125, 150, 200, 250

Occurrence: Optional

selectedInventoryDiscounts.discountBenefit.amountOffOrder.currencyCurrencyCodeEnum

The base currency applied to the value field to establish a monetary amount.

The currency is represented as a 3-letter ISO 4217 currency code. For example, the code for the Canadian Dollar is CAD.

Default: The default currency of the eBay marketplace that hosts the listing.

Occurrence: Conditional

selectedInventoryDiscounts.discountBenefit.amountOffOrder.valuestring

The monetary amount in the specified currency.

Required in the amount type.

Occurrence: Conditional

selectedInventoryDiscounts.discountBenefit.percentageOffItemstring

The percentage applied to the sales price that is discounted off the promoted item (or items) when the promotion criteria is met.

Valid integer values for percentage off:   Min: 5   Max: 80

Occurrence: Optional

selectedInventoryDiscounts.discountBenefit.percentageOffOrderstring

Used for threshold promotions, this is the percentage of the order price that is discounted off the order when the promotion criteria is met. This field is not value for markdown promotions.

Valid integer values for ORDER_DISCOUNT promotions:   Min: 5   Max: 80

For VOLUME_DISCOUNT promotions: Must be set to 0 for the first discount rule.

Occurrence: Optional

selectedInventoryDiscounts.discountIdstring

A unique, eBay-generated ID that you can use to identify the discount. This field is ignored in POST and PUT operations.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterionInventoryCriterion

A container that defines either the listing IDs or the selection rules that specify the items to include in the promotion. Listing IDs can be either eBay listing IDs or a list of the seller's inventory reference IDs (know as SKUs or custom labels). See the selectionRules container for the rule criteria you can use to select inventory.

Note: All listings in Promotions Manager promotions must support an electronic payment method.

Occurrence: Required

selectedInventoryDiscounts.inventoryCriterion.inventoryCriterionTypeInventoryCriterionEnum

Indicates how the items to include in the promotion are selected. You can include inventory by ID, using rules, or globally include all your inventory.

Occurrence: Required

selectedInventoryDiscounts.inventoryCriterion.inventoryItemsarray of InventoryItem

An array of containers for the seller's inventory reference IDs (also known as an "SKU" or "custom label") to be added to the promotion.

Note: The request can have either inventoryItems or listingIds, but not both.


Maximum: 500 parent items

Maximum SKU or custom label length: 50 characters

Required if InventoryCriterionType is set to INVENTORY_BY_VALUE, you must specify either inventoryItems or listingIds.

Occurrence: Conditional

selectedInventoryDiscounts.inventoryCriterion.inventoryItems.inventoryReferenceIdstring

The unique identifier of a single-item listing or a multi-variation listing.

To create an ad for a single-item listing, set the inventoryReferenceType value to INVENTORY_ITEM and specify and item ID or a SKU (if the SKU is defined in the listing)

To create an ad for a multi-variation listing, set the inventoryReferenceType value to INVENTORY_ITEM_GROUP and specify the item ID for the multi-variation listing or the inventoryitemGroupKey value as defined in the Inventory API.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.inventoryItems.inventoryReferenceTypeInventoryReferenceTypeEnum

Indicates the type of the inventoryReferenceId, which can be either INVENTORY_ITEM or INVENTORY_ITEM_GROUP.

Note: This value is not currently returned in the response.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.listingIdsarray of string

An array of eBay listing IDs to be added to the promotion.

Note: The request can have either inventoryItems or listingIds, but not both.


Required: All listings in a promotion must offer an electronic payment method.

Maximum: 500 parent items

Maximum SKU or custom label length: 50 characters

Required if InventoryCriterionType is set to INVENTORY_BY_VALUE, you must specify either inventoryItems or listingIds.

Occurrence: Conditional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteriaRuleCriteria

This container defines a set of inventory selection rules for a promotion.

When defining rule criteria, you must limit item exclusions to 100 IDs when you choose from live inventory.

Required if InventoryCriterionEnum is set to INVENTORY_BY_RULE or INVENTORY_ANY.

Occurrence: Conditional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.excludeInventoryItemsarray of InventoryItem

A list of seller inventory reference IDs to exclude from the promotion.

Note: The request can have either excludeInventoryItems or excludeListingIds but not both.

Maximum: 100 parent items

Maximum SKU or custom label length: 50 characters

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.excludeInventoryItems.inventoryReferenceIdstring

The unique identifier of a single-item listing or a multi-variation listing.

To create an ad for a single-item listing, set the inventoryReferenceType value to INVENTORY_ITEM and specify and item ID or a SKU (if the SKU is defined in the listing)

To create an ad for a multi-variation listing, set the inventoryReferenceType value to INVENTORY_ITEM_GROUP and specify the item ID for the multi-variation listing or the inventoryitemGroupKey value as defined in the Inventory API.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.excludeInventoryItems.inventoryReferenceTypeInventoryReferenceTypeEnum

Indicates the type of the inventoryReferenceId, which can be either INVENTORY_ITEM or INVENTORY_ITEM_GROUP.

Note: This value is not currently returned in the response.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.excludeListingIdsarray of string

A list of eBay listing IDs to exclude from the promotion.

Note: The request can have either excludeInventoryItems or excludeListingIds but not both.

Maximum: 100 parent items
Maximum SKU or custom label length: 50 characters

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.markupInventoryItemsarray of InventoryItem

A list of SKUs to remove from a markdown promotion. The listed SKUs are 'marked up' to their standard price after being part of the markdown promotion.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.markupInventoryItems.inventoryReferenceIdstring

The unique identifier of a single-item listing or a multi-variation listing.

To create an ad for a single-item listing, set the inventoryReferenceType value to INVENTORY_ITEM and specify and item ID or a SKU (if the SKU is defined in the listing)

To create an ad for a multi-variation listing, set the inventoryReferenceType value to INVENTORY_ITEM_GROUP and specify the item ID for the multi-variation listing or the inventoryitemGroupKey value as defined in the Inventory API.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.markupInventoryItems.inventoryReferenceTypeInventoryReferenceTypeEnum

Indicates the type of the inventoryReferenceId, which can be either INVENTORY_ITEM or INVENTORY_ITEM_GROUP.

Note: This value is not currently returned in the response.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.markupListingIdsarray of string

A list of listing IDs to remove from a markdown promotion. The listed items are 'marked up' to their standard price after being part of the markdown promotion.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRulesarray of SelectionRule

The container for the rules that select the items to include in a promotion.

Required if inventoryCriterionType is set to INVENTORY_BY_RULE.

For information on using the contained fields, see Item promotions.

Occurrence: Conditional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRules.brandsarray of string

An array of product brands. For more details, see Using the selectionRules container.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRules.categoryIdsarray of string

This field contains an array of the associated category ID(s).

For Item promotions, a single-item array containing the category ID associated with the promotion. Required when used in an Item promotion and either specifying a selectionRules container or when inventoryCriterionType is set to INVENTORY_BY_RULE.

For Promoted Listing campaigns, an array of category ID(s) associated with the campaign.

For information on how to get category IDs, see eBay Marketplace category IDs and Seller store category IDs

Occurrence: Conditional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRules.categoryScopeCategoryScopeEnum

This enumerated value indicates if the category ID for the item is an identifier for eBay categories or for a seller's eBay store categories.

For Promoted Listing campaigns, this field includes the type of the category ID for the item(s) to be included in the campaign.

For Item promotions, this field identifies the scope for the corresponding array as eBay categories or for a seller's eBay store categories. Required when used in an Item promotion and inventoryCriterionType is set to INVENTORY_BY_RULE.

Occurrence: Conditional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRules.listingConditionIdsarray of string

A comma-separated list of unique identifiers for the conditions of listings to be included

For Promoted Listing campaigns, refer to Add items to the PLS campaign. Up to four IDs can be specified.

For Item promotions, refer to Item condition ID and name values.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRules.maxPriceAmount

This container sets the maximum price threshold. For more details, see Using the selectionRules container.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRules.maxPrice.currencyCurrencyCodeEnum

The base currency applied to the value field to establish a monetary amount.

The currency is represented as a 3-letter ISO 4217 currency code. For example, the code for the Canadian Dollar is CAD.

Default: The default currency of the eBay marketplace that hosts the listing.

Occurrence: Conditional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRules.maxPrice.valuestring

The monetary amount in the specified currency.

Required in the amount type.

Occurrence: Conditional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRules.minPriceAmount

This container sets the minimum price threshold. For more details, see Using the selectionRules container.

Occurrence: Optional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRules.minPrice.currencyCurrencyCodeEnum

The base currency applied to the value field to establish a monetary amount.

The currency is represented as a 3-letter ISO 4217 currency code. For example, the code for the Canadian Dollar is CAD.

Default: The default currency of the eBay marketplace that hosts the listing.

Occurrence: Conditional

selectedInventoryDiscounts.inventoryCriterion.ruleCriteria.selectionRules.minPrice.valuestring

The monetary amount in the specified currency.

Required in the amount type.

Occurrence: Conditional

selectedInventoryDiscounts.ruleOrderinteger

For markdown promotions, this field is reserved for future use.

Occurrence: Optional

startDatestring

The date and time the promotion starts in UTC format (yyyy-MM-ddThh:mm:ssZ). For display purposes, convert this time into the local time of the seller.

Occurrence: Required

Output

HTTP response headers

This call has no response headers.

Response payload

This call has no payload.

Response fields

This call has no field definitions.

HTTP status codes

This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.

StatusMeaning
200Success
204Success
400Bad Request
404Not Found
409Business Error
500Internal Server Error

Error codes

For more on errors, plus the codes of other common errors, see Handling errors.

CodeDomainCategoryMeaning
38201API_MARKETINGAPPLICATIONInternal server error encountered. If this problem persists, please contact support.
38203API_MARKETINGREQUESTResource not found. Check the ID and try the call again.
38204API_MARKETINGREQUESTThe seller is not eligible for promotions because they do not have an eBay Store or they have not accepted the terms and conditions for creating a promotion on this Marketplace, see the documentation for this call.
38218API_MARKETINGREQUESTA valid entry is required for {fieldName}.
38219API_MARKETINGREQUESTThe start date and time must be earlier than the end date and time.
38220API_MARKETINGREQUESTThe end date and time must be later than the current date and time.
38225API_MARKETINGREQUESTYou cannot update a promotion that has ended.
38228API_MARKETINGREQUESTThe amount value of '{fieldName}' contains decimals, only integers are supported.
38229API_MARKETINGREQUESTThe start date and time should be later than the current date and time.
38232API_MARKETINGREQUESTYou cannot update the promotion discount for an active promotion.
38234API_MARKETINGREQUESTHTML is not allowed in the '{fieldName}' field.
38235API_MARKETINGREQUESTInvalid input for the '{fieldName}' field. For help, see the documentation for this call.
38238API_MARKETINGREQUESTThe 'discountBenefit' data is missing, which is required by this call. For help, see the documentation for this call.
38240API_MARKETINGREQUESTInvalid input for the 'promotionStatus' field. For help, see the documentation for this call.
38242API_MARKETINGREQUESTThe request can have only one of these fields: 'inventoryCriterion.inventoryItems' or 'inventoryCriterion.listingIds'.
38248API_MARKETINGBUSINESSThe 'percentOffItem' value is invalid. For help, see the documentation for this call.
38250API_MARKETINGBUSINESSThe 'amountOffItem' value is invalid. For help, see the documentation for this call.
38255API_MARKETINGREQUESTThe promotion description exceeds the maximum length, which is {promoDescriptionLength}.
38256API_MARKETINGREQUESTThe promotion name exceeds the maximum length, which is {promoNameLength}.
38260API_MARKETINGREQUESTTo update the start date of a promotion, the promotion must be in draft or scheduled state.
38261API_MARKETINGREQUESTPromotions are currently limited to a maximum of {maxListingInclLimit} parent items, when entering item IDs or choosing from live inventory.
38262API_MARKETINGREQUESTYou can only include up to {maxSkuInclLimit} SKUs or custom labels in inventoryItems.
38269API_MARKETINGREQUESTThe promotion ID does not match any of the seller's promotions.
38270API_MARKETINGREQUESTThe currency type does not match what is used for the Marketplace ID submitted.
345056API_MARKETINGREQUESTThe request can have only one of these field types: 'inventoryItems' or 'listingIds'.
345057API_MARKETINGREQUESTThe request can have only one of these fields: 'percentageOffItem', or 'amountOffItem' in 'discountBenefit'. For help, see the documentation for this call.
345058API_MARKETINGREQUESTWhen using multiple selectedInventoryDiscounts containers, each must have a unique percentageoffitems value. For help, see the documentation for this call.
345059API_MARKETINGREQUESTIf using percentageoffitems you can have between 1 and 10 selectedInventoryDiscounts containers. For help, see the documentation for this call.
345060API_MARKETINGREQUESTIf using amountoffitems you can only have selectedInventoryDiscounts container. For help, see the documentation for this call.
345061API_MARKETINGREQUESTThe discount ID value is a read only value.
345063API_MARKETINGREQUESTPriority is not supported for the item_price_markdown calls.
345065API_MARKETINGREQUESTYou cannot change the status of aa SCHEDULED promotion to DRAFT. For help, see the documentation for this call.
345070API_MARKETINGREQUESTThe giving discount ID does not exist in the promotion. For help, see the documentation for this call.
345071API_MARKETINGREQUESTThe giving discount type is not consistent with existing active promotion. For help, see the documentation for this call.
345072API_MARKETINGREQUESTThe giving inventory criterion type is not consistent with existing active promotion. For help, see the documentation for this call.
345110API_MARKETINGREQUESTYou can specify only one of Inventory Items, Listing IDs or Rules in the Inventory Criterion.
345111API_MARKETINGREQUESTYou cannot specify Rules when using the Inventory by Value Criterion.
345114API_MARKETINGREQUESTA Category scope is required for the Rule. Please refer to API documentation for allowed values.
345115API_MARKETINGREQUESTAt least one Category is required. Please provide a valid input for this field and try again.
345116API_MARKETINGREQUESTYou can specify only Marketplace categories or Store categories when creating Rules.
345120API_MARKETINGREQUESTInvalid Item condition. Please refer to API documentation for allowed values.
345121API_MARKETINGREQUESTYou cannot specify Rules or inventory items when using the Inventory by ALL Criterion.
345122API_MARKETINGREQUESTcategory ids cannot be specified with the inventory of type any.
345123API_MARKETINGREQUESTbrands cannot be specified with inventory of type any or Store.
345125API_MARKETINGREQUESTYou cannot specify a child Marketplace Category ID when the parent Marketplace Category ID is already specified. Please refer to the API documentation to source allowed values.
345126API_MARKETINGREQUESTYou cannot specify a child Store Category ID when the parent Store Category ID is already specified. Please refer to the API documentation to source allowed values.

Warnings

For more on warnings, plus the codes of other common warnings, see Handling errors.

CodeDomainCategoryMeaning
38226API_MARKETINGREQUESTThe listing ID must be numeric if you're using listingIds.
38227API_MARKETINGREQUESTThe listing ID is invalid.
38263API_MARKETINGREQUESTThe SKU or custom label used in inventoryReferenceId exceeds the maximum length, which is {skuLength}.
38272API_MARKETINGBUSINESSThis listing is not eligible for a promotion because it's an auction-style listing.
38273API_MARKETINGBUSINESSThis listing is not eligible for a promotion because it's a minimum advertised price (MAP) listing.
38274API_MARKETINGBUSINESSYou haven't included electronic payment method as a payment method. In order to make this listing eligible, update it to include electronic payment method.
38275API_MARKETINGBUSINESSThis SKU used in inventoryReferenceId matches an item that is part of a listing with variations. This SKU is only eligible if we add all of the listing variations. To add this listing, use the parent, or main, SKU (custom label).
345064API_MARKETINGREQUESTYou have moved inventory between discountBenefit containers or have the same inventory in multiple discountBenefit containers. For help, see the documentation for this call.
345112API_MARKETINGREQUESTInvalid Store category. Please refer to API documentation to source allowed values.
345113API_MARKETINGREQUESTInvalid marketplace category ID. Please refer to API documentation for the supported values.

Samples

New to making API calls? Please see Making a Call.

Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.

Sample 1: Update a markdown promotion

This sample changes the applyFreeShipping value to true and sets the discount value to $10 (from $5) on a scheduled markdown promotion. This example does not specify any inventory criterion, but to avoid a null pointer exception, it adds rule criteria with null values. The seller can specify different rule criteria with null values, or non-null rule criteria.

Input

The input to this call is a the full markdown promotion as it was originally posted, plus any fields containing changed values. This sample updates both the applyFreeShipping and value fields. Use the getItemPriceMarkdownPromotion call to retrieve the details of the original and updated promotion.

PUThttps://api.ebay.com/sell/marketing/v1/item_price_markdown/1*********9@EBAY_US

Output

A successful call returns the HTTP status code 204 No Content, which indicates the promotion was updated as specified. This method has no response payload.