Promotions and taxes
Seller opt-in or opt-out
Adds or removes one or more sellers to or from a specified promotion.
⚠️ When the first seller opts in to an inactive promotion, it's activated, and when the last seller opts out, it's deactivated.
Permissions
Any user or application key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise they will receive a status code 401 error. These are the applicable resources for this endpoint
| Product | Category | Resource |
|---|---|---|
| Rates and Benefits | Manage external seller promos | External_Seller_Promotions |
post/api/rnb/pvt/calculatorconfiguration/{promotionId}/seller-opt
Path parameters
promotionIdstring required
Example:d8a10358-cbb7-42ae-b020-91e104d997e7
The ID of the promotion.
Query parameters
anstring required
Example:mystore
The VTEX account name that owns the promotion.
Headers
Content-Typestring required
Type of the content being sent.
Acceptstring required
HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.
if-Matchstring required
Example:2025-05-27T14:05:41.7706903Z
Must match the current lastModified value of the promotion.
Request body
Example request
{
"sellerIds": [
"seller-id-1"
],
"operation": "OptIn"
}Response
Opt-in or opt-out executed successfully.