Update advertiser Seller preference

PUT /api/v2/buyer/storefronts/{storefrontId}/advertisers/{advertiserId}/activation-preference Sets whether one advertiser inherits, uses, or does not use one exact Seller. The caller must have the ADMIN or SUPER_ADMIN account role, and the advertiser must belong to the authenticated buyer account.

Scope boundary

Use this operation while managing one advertiser. It changes only the edge between that advertiser and the selected Seller. To change Seller selection for every current and future advertiser in the buyer account, use Update Seller selection instead.

Decisions

DEFAULT removes the explicit preference and inherits account selection and automatic market/channel matching.
ENABLED uses the Seller for this advertiser only.
DISABLED does not use the Seller for this advertiser only.

Hard marketplace and transaction ineligibility always wins. Account-wide ALWAYS_INCLUDE and ALWAYS_EXCLUDE selection also remains authoritative; a stored advertiser preference takes effect when account selection is DEFAULT. This operation does not create or remove an authorization grant and does not change billing or data-sharing permission.

Request

curl -X PUT \
  "https://api.interchange.io/api/v2/buyer/storefronts/42/advertisers/84/activation-preference" \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "decision": "DISABLED"
  }'

Parameters

Field	In	Type	Required	Notes
`storefrontId`	path	positive integer	Yes	Exact Seller/Storefront ID
`advertiserId`	path	positive integer	Yes	Advertiser owned by the buyer account
`decision`	body	enum	Yes	`DEFAULT`, `ENABLED`, or `DISABLED`

Response

{
  "buyerCustomerId": 123,
  "advertiserId": "84",
  "storefrontId": "42",
  "decision": "DISABLED"
}

Public V3 equivalent

Call save_connection with one advertiser activation intent:

{
  "sellerId": "42",
  "advertiserActivation": {
    "advertiserId": "84",
    "decision": "DISABLED"
  }
}

The selection and advertiserActivation intents are mutually exclusive.

Errors

400 VALIDATION_ERROR — an ID or decision is invalid.
401 UNAUTHORIZED — the bearer token is missing or invalid.
403 ACCESS_DENIED — the caller is not an administrator or the advertiser does not belong to this buyer account.
404 NOT_FOUND — the Seller does not exist.

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Update advertiser Seller preference

Scope boundary

Decisions

Request

Parameters

Response

Public V3 equivalent

Errors

​Scope boundary

​Decisions

​Request

​Parameters

​Response

​Public V3 equivalent

​Errors

Scope boundary

Decisions

Request

Parameters

Response

Public V3 equivalent

Errors