PAUSED. Pausing a promotion makes the promotion temporarily unavailable to buyers and any currently-incomplete transactions will not receive the promotional offer until the promotion is resumed. Also, promotion teasers are not displayed when a promotion is paused.
Pass the ID of the promotion you want to pause using the promotion_id path parameter. Call getPromotions to retrieve the IDs of the seller's promotions.
Note: You can only pause threshold promotions (you cannot pause markdown promotions).
Resource URI (production)
|promotion_id||string||This path parameter takes a concatenation of the ID of the promotion you want to pause 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.
HTTP request headers
This request requires an access token created with the authorization code 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):
See OAuth access tokens for more information.
For more on errors, plus the codes of other common errors, see Handling errors.
|38201||API_MARKETING||APPLICATION||Internal server error encountered. If this problem persists, contact the eBay Developers Program for support.|
|38203||API_MARKETING||REQUEST||Resource not found. Check the ID and try the call again.|
|38204||API_MARKETING||REQUEST||The 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.|
|38214||API_MARKETING||REQUEST||A promotion can only be paused if it is scheduled or running.|
|345077||API_MARKETING||REQUEST||You cannot update a promotion that was not created through the API.|
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.