Docs | distribution.tech

Start here

Run a campaign with your agent: connect an agent, the eight-step flow, the spending mandate and every error code.
Your first call: GET /inventory over REST, or the inventory tool over MCP, reads how well the network reaches your audience today.
The API reference: every endpoint under https://app.distribution.tech/api/v1.
The MCP tools: every tool on https://app.distribution.tech/api/mcp.
The OpenAPI document and the changelog of what changed each week.

Authentication

Create an API key in Developers in your workspace and send it on every request as Authorization: Bearer plus the key. Each endpoint names the scope its key needs. A request that changes something also takes an Idempotency-Key header (an idempotency_key argument over MCP), so a retry never runs twice.

REST base URL: https://app.distribution.tech/api/v1
MCP server: https://app.distribution.tech/api/mcp
Contract version: 1.24.0

API reference

Inventory and audience

Inventory and audience endpoints
Endpoint	What it does	Scope
`GET /audience`	Audience fit for one of your campaigns, or for a profile	`audience:read`
`GET /inventory`	Network coverage for your audience	`inventory:read`

Creators

Creators endpoints
Endpoint	What it does	Scope
`GET /creators`	Approved creators on sale now, by name, with price per format and format advice	`creators:read`
`GET /creators/{id}`	One creator's full profile	`creators:read`
`POST /creators/{id}/price-request`	Ask for a price	`creators:read`

Campaigns

Campaigns endpoints
Endpoint	What it does	Scope
`GET /campaigns`	Your campaigns and where each stands	`campaigns:read`
`POST /campaigns`	Start a campaign	`campaigns:write`
`GET /campaigns/{id}`	Where one campaign stands	`campaigns:read`
`PATCH /campaigns/{id}`	Rename a campaign	`campaigns:write`
`DELETE /campaigns/{id}`	Delete a draft campaign	`campaigns:write`
`POST /campaigns/{id}/archive`	Archive a campaign	`campaigns:write`
`POST /campaigns/{id}/creator-guidelines`	Set the creator guidelines	`campaigns:write`

Plans

Plans endpoints
Endpoint	What it does	Scope
`POST /plans/{id}/approve`	Approve and get the pay link	`plans:approve`
`POST /plans/{id}/dates`	Move a plan's dates	`campaigns:write`
`POST /plans/{id}/lines`	Add a creator	`campaigns:write`
`GET /plans/{id}/quote`	A plan as you sign it	`campaigns:read`
`DELETE /plans/{id}/lines/{line_id}`	Remove a creator	`campaigns:write`
`POST /plans/{id}/lines/{line_id}/swap`	Swap a creator	`campaigns:write`

Proof and results

Proof and results endpoints
Endpoint	What it does	Scope
`GET /evidence`	Proof of each post a paid campaign put live	`evidence:read`
`GET /results`	Results of each post a paid campaign put live	`results:read`

Company context

Company context endpoints
Endpoint	What it does	Scope
`GET /brain`	Your company context and its version	`brain:read`

Feedback

Feedback endpoints
Endpoint	What it does	Scope
`GET /feedback`	Your feedback	`any valid key`
`POST /feedback`	Send feedback	`any valid key`

MCP tools

MCP tools
Tool	What it does	Changes data
`inventory`	Network coverage	No
`resolve_audience`	Resolve an audience	No
`campaign_status`	Campaign status	No
`evidence`	Proof of delivery	No
`results`	Results	No
`brain_get`	Company context	No
`creators_search`	Find creators	No
`creator_get`	One creator	No
`creator_ask_price`	Ask for a price	No
`plan_quote`	Quote a plan	No
`create_campaign`	Start a campaign	Yes
`plan_add_creator`	Add a creator	Yes
`plan_remove_creator`	Remove a creator	Yes
`plan_move_dates`	Move a plan's dates	Yes
`plan_swap_creator`	Swap a creator	Yes
`set_creator_guidelines`	Set the creator guidelines	Yes
`approve_plan`	Approve and get the pay link	Yes
`archive_campaign`	Archive a campaign	Yes
`rename_campaign`	Rename a campaign	Yes
`delete_campaign`	Delete a draft campaign	Yes
`feedback_send`	Send feedback	No
`feedback_list`	Your feedback	No

Connect your agent

A key comes from Developers once your brand is approved. Connect an agent to ask for access, then follow the agent guide.