Deprecated. This page documents the v2 buyer API, which is closed to new API
clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer
REST integration to V3. The conversion endpoint,
Log event, stays open.
POST /api/v2/buyer/campaign-suggestion-sets/:campaignSuggestionSetId/approveApproves the entire set — every media buy it moves budget between. There is no
per-media-buy approval: the members are two sides of one transfer, so approving
part of it would either create budget the campaign never freed or strand budget it
did. See campaign suggestion sets for why.
Only a set in AWAITING_APPROVAL can be approved. A set that has since been
superseded by a newer run, expired because one of its media buys changed, or
already been decided returns 409 — the decision is refused rather than applied
to a recommendation that no longer describes your campaign.
Request
curl -X POST https://api.apostra.com/api/v2/buyer/campaign-suggestion-sets/77/approve \ -H "Authorization: Bearer $SCOPE3_API_KEY"
No request body. Approval takes no reason — only
rejection does. A body
sent here is ignored rather than rejected.
Parameters
Field
Type
Required
Notes
campaignSuggestionSetId
string
Yes
Set id (path parameter) — digits only, no leading zero, up to 18 digits.
The approval is recorded against every member suggestion at once, so the set and
its members can never disagree about whether the transfer was accepted.APPROVED means the transfer is cleared to run, not that it has run. Apostra
then sends the changes to your sellers and confirms each one, moving the set to
APPLYING and on to APPLIED — or reversing the whole transfer if a change
cannot be made. If the reversal itself cannot complete, the set stops at
NEEDS_RECONCILIATION and a person puts the budgets right. How long that takes is up to your sellers: the decreases are
confirmed before any increase is sent, and a reversal waits on them the same way.
Poll
get campaign suggestion set for
the outcome, and see what happens after you
approve.
Errors
Status
When
404
No such set, or it belongs to another account.
409
The set is not in AWAITING_APPROVAL — already decided, superseded, expired, or parked.