Skip to main content
A planning brief is a prospective brief you share with one or more publisher targets before committing to a campaign. You describe the audience, geo, channels, budget, and dates; Interchange dispatches the brief to each target and records the responses sellers send back — quotes, clarifying questions, declines, and bookings. Use it to test demand and gather priced options across multiple publishers in a single transaction. Each target identifies either an Interchange storefront (LIVE or COMING_SOON) or an external publisher (NOT_ON_INTERCHANGE), and the target’s bucket drives how Interchange dispatches the brief (notify, watch, or invite). A brief moves through a lifecycle status: SEARCHING on create, QUOTED once at least one seller responds, BOOKED when a target converts to a deal, ABANDONED after idle, or DECLINED if every target declined. The buyer-facing view never exposes the internal matchScore aggregate that sellers see.

​
Key concepts

ConceptDescription
Planning briefA prospective brief (demand signal) shared with publisher targets
TargetOne publisher row — a storefront (LIVE/COMING_SOON) or external publisher (NOT_ON_INTERCHANGE)
bucketLIVE, COMING_SOON, or NOT_ON_INTERCHANGE — drives dispatch action
statusSEARCHING → QUOTED → BOOKED, or ABANDONED / DECLINED
targetingModeDIRECT (named sellers), FILTERED (≤5 matches), BROAD (>5)
ResponseA seller action against a target: QUOTE, CLARIFY, DECLINE, or BOOK
dispatchStatusPer-target delivery state: QUEUED, DISPATCHED, ACKNOWLEDGED, ON_HOLD, FAILED, DECLINED

​
Task reference

List planning briefs

GET /planning-briefs — briefs you’ve shared

Share a planning brief

POST /planning-briefs — create and dispatch

Get planning brief

GET /planning-briefs/:briefId — brief with target rows

List brief responses

GET /planning-briefs/:briefId/responses — seller replies