Set per-buyer auto-approve

PUT /api/v2/storefront/buyer-auto-approvals/{buyerCustomerId} Opts one buyer into (enabled: true) or out of (enabled: false) automatic approval for their media buys. This is an idempotent upsert keyed on (storefront, buyerCustomerId) — calling it again updates the existing override. The storefront is resolved from your authenticated identity, never the request body. While enabled, that buyer’s media buys skip both Brief Acceptance screening and your review queue. It affects media buys only (creative review is a separate gate) and only takes effect while mediaBuyApproval is manual.

Request

curl

curl -X PUT https://api.interchange.io/api/v2/storefront/buyer-auto-approvals/804 \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "reason": "Coke — pre-cleared 2026 always-on."
  }'

To revoke trust, send {"enabled": false}. The override row is kept for your audit trail — there is no delete.

Parameters

Field	Type	Required	Notes
`buyerCustomerId`	path, number	Yes	Account id of the buyer. Must be a buyer that has submitted a media buy to this storefront
`enabled`	boolean	Yes	`true` to auto-approve this buyer’s media buys; `false` to revoke
`reason`	string \| null	No	Operator note. Omit to keep the existing note; `null` to clear it. Max 2000 chars

Response

{
  "id": "42",
  "storefrontId": "1234",
  "buyerCustomerId": 804,
  "buyerName": "Coca-Cola",
  "autoApproveEnabled": true,
  "reason": "Coke — pre-cleared 2026 always-on.",
  "createdAt": "2026-06-28T15:00:00.000Z",
  "updatedAt": "2026-06-28T15:00:00.000Z",
  "createdBy": "11",
  "createdByCustomerId": 1234,
  "updatedByCustomerId": 1234,
  "policyBypassCount": 0,
  "lastPolicyBypassAt": null
}

Returns 200 with the override. buyerName is the resolved buyer company/name for your confirmation; the actor fields record who armed and last changed the override. policyBypassCount / lastPolicyBypassAt record how often this override auto-forwarded a buy that the policy evaluator would otherwise have held, and when the latest such bypass occurred.

Errors

400 VALIDATION_ERROR — enabled missing or not a boolean, or a non-numeric buyerCustomerId.
404 NOT_FOUND — no storefront exists for the caller, or the buyer has no media buys on this storefront (fail-closed: you can’t opt in a buyer that hasn’t submitted a media buy to you).
401 UNAUTHORIZED — missing or invalid bearer token.

See Errors for the full error contract.

Per-buyer auto-approve

What the override does, and what it deliberately doesn’t.

List per-buyer auto-approvals

Read every override on the storefront.

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Set per-buyer auto-approve

Request

Parameters

Response

Errors

Per-buyer auto-approve

List per-buyer auto-approvals

​Request

​Parameters

​Response

​Errors

​Related

Per-buyer auto-approve

List per-buyer auto-approvals

Request

Parameters

Response

Errors

Related