Properties
| Name | Type | Description |
|---|---|---|
| campaign_id | string | |
| status | string | |
| plan | object | |
| plan_note | stringnull | |
| defaults | array | The fields filled because the request left them out. |
| budget | object | The budget the campaign was stored with. held is true when budget_usd alone was held lower, to what the mandate allows. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/distribution-tech/main/json-schema/distribution-tech-campaign-created-schema.json",
"title": "CampaignCreated",
"x-generated": "2026-10-22",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/distribution-tech-openapi.json#/components/schemas/CampaignCreated",
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"format": "uuid"
},
"status": {
"type": "string",
"enum": [
"plan_ready",
"no_plan"
]
},
"plan": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/$defs/Quote"
}
]
},
"plan_note": {
"type": [
"string",
"null"
]
},
"defaults": {
"type": "array",
"items": {
"type": "string",
"enum": [
"company",
"audience",
"geography",
"desired_outcome"
]
},
"description": "The fields filled because the request left them out."
},
"budget": {
"type": "object",
"properties": {
"min_usd": {
"type": [
"integer",
"null"
]
},
"max_usd": {
"type": [
"integer",
"null"
]
},
"held": {
"type": "boolean"
}
},
"required": [
"min_usd",
"max_usd",
"held"
],
"additionalProperties": false,
"description": "The budget the campaign was stored with. held is true when budget_usd alone was held lower, to what the mandate allows."
}
},
"required": [
"campaign_id",
"status",
"plan",
"plan_note"
],
"additionalProperties": false,
"$defs": {
"Mandate": {
"type": [
"object",
"null"
],
"properties": {
"key_id": {
"type": "string",
"format": "uuid"
},
"version": {
"type": "integer"
},
"max_plan_cents": {
"type": "integer"
},
"monthly_cap_cents": {
"type": "integer"
},
"channels": {
"type": "array",
"items": {
"type": "string"
}
},
"may_approve": {
"type": "boolean"
},
"may_exceed_budget": {
"type": "boolean",
"deprecated": true,
"description": "Retired, always false. No key and no person can approve a plan over its campaign's budget: approve_plan refuses it with over_budget until a creator is removed or the budget is raised."
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"spent_this_month_cents": {
"type": "integer"
},
"terms_version": {
"type": [
"string",
"null"
],
"description": "The brand terms a person accepted for this key. Null on a mandate that may not sign (the terms govern signing) and on the workspace's own agent key."
},
"terms_accepted_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"terms_accepted_email": {
"type": [
"string",
"null"
]
}
}
},
"PaymentOption": {
"type": "object",
"properties": {
"rail": {
"type": "string",
"enum": [
"checkout",
"invoice"
]
},
"label": {
"type": "string"
},
"clears": {
"type": "string"
}
},
"required": [
"rail",
"label",
"clears"
],
"additionalProperties": false
},
"Quote": {
"type": "object",
"description": "A plan as the person sees it and as an agent signs it (v1-product-spec 8.5 Quote).",
"properties": {
"plan_id": {
"type": "string",
"format": "uuid"
},
"campaign_id": {
"type": "string",
"format": "uuid"
},
"version": {
"type": "integer"
},
"status": {
"type": "string",
"enum": [
"awaiting_approval",
"approved"
]
},
"currency": {
"type": "string"
},
"launch_window_start": {
"type": "string",
"format": "date"
},
"launch_window_end": {
"type": "string",
"format": "date"
},
"terms_fingerprint": {
"type": "string",
"description": "Send exactly this to approve. It changes when a line, a price or the dates change."
},
"total_cents": {
"type": "integer"
},
"totals": {
"type": "object",
"description": "creators, total_cents, views_low, views_high, unmeasured, cpm_low_cents, cpm_high_cents, tiers, budget_cents, remaining_cents."
},
"lines": {
"type": "array",
"items": {
"$ref": "#/$defs/QuoteLine"
}
},
"payment_options": {
"type": "array",
"items": {
"$ref": "#/$defs/PaymentOption"
}
},
"agent_payment": {
"type": "string",
"enum": [
"checkout",
"team_invoice"
]
},
"brand_terms": {
"type": "object",
"properties": {
"current_version": {
"type": [
"string",
"null"
],
"description": "The current brand terms version id (a date)."
},
"current_number": {
"type": [
"integer",
"null"
],
"description": "The number the app shows for that version (version 3)."
},
"url": {
"type": [
"string",
"null"
]
},
"accepted_for_this_key": {
"type": [
"string",
"null"
]
},
"accepted_number_for_this_key": {
"type": [
"integer",
"null"
]
}
},
"required": [
"current_version",
"current_number",
"url",
"accepted_for_this_key",
"accepted_number_for_this_key"
],
"additionalProperties": false
},
"mandate": {
"$ref": "#/$defs/Mandate"
},
"policy": {
"type": "object",
"description": "allowed: whether this key's mandate lets it sign now; refusal: the reason and numbers when not (over_budget when the plan is over the campaign's budget, which no mandate can approve: remove a creator or have the brand raise the budget).",
"properties": {
"allowed": {
"type": "boolean"
},
"refusal": {
"type": [
"object",
"null"
]
}
}
},
"blocked_lines": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
},
"over_budget": {
"type": [
"object",
"null"
],
"description": "The plan over its campaign's budget: budget_cents, total_cents and over_by_cents, at current prices when a creator's price rose past the budget (the plan then keeps its earlier prices, so total_cents alone reads as within it). Null within the budget, with no budget, or once signed. Approval refuses it until a creator is removed or the budget is raised.",
"properties": {
"budget_cents": {
"type": "integer"
},
"total_cents": {
"type": "integer"
},
"over_by_cents": {
"type": "integer"
}
}
},
"order": {
"type": [
"object",
"null"
]
},
"valid_while": {
"const": "terms_fingerprint_unchanged"
}
}
},
"QuoteLine": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"creator": {
"oneOf": [
{
"type": "null"
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The creator's id, for creator_get. Left out when not known."
},
"name": {
"type": [
"string",
"null"
]
},
"handle": {
"type": [
"string",
"null"
],
"description": "The creator's X handle (every creator on a plan line is approved, so it is named before payment)."
},
"profile_url": {
"type": [
"string",
"null"
],
"description": "The creator's X profile link (every creator on a plan line is approved, so it is named before payment)."
},
"avatar_url": {
"type": "string",
"format": "uri",
"description": "The creator's live profile photo. Left out when there is none."
},
"followers": {
"type": "integer",
"minimum": 0,
"description": "The creator's follower count on the channel. Left out when not measured."
}
},
"required": [
"name",
"handle",
"profile_url"
],
"additionalProperties": false
}
]
},
"creator_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "The creator's id at the top level (the same as creator.id); null when not known."
},
"unit_id": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"stage_id": {
"type": "string",
"enum": [
"planned",
"offered",
"creator_confirmed",
"scheduled",
"live",
"proof_attached",
"cancelled"
],
"description": "Where this post stands; the same stage model as a campaign's lines_by_stage. Branch on this, never on stage."
},
"stage": {
"type": "string",
"description": "The label for stage_id: Planned, Offered, Creator confirmed, Scheduled, Live, Proof attached, Cancelled."
},
"channel": {
"type": "string"
},
"channel_label": {
"type": "string"
},
"format": {
"type": [
"string",
"null"
]
},
"deliverable": {
"type": "string"
},
"scheduled_date": {
"type": "string",
"format": "date"
},
"price_cents": {
"type": "integer",
"description": "The all-in price of this line. Never split into parts."
},
"review": {
"type": [
"string",
"null"
],
"description": "The creator's review state in brand words: Approved, or Under review. Null for a line with no creator yet."
},
"vetting": {
"type": [
"string",
"null"
],
"deprecated": true,
"x-sunset": "2026-11-20",
"description": "Deprecated: the same value as review. Removed on 2026-11-20; read review."
},
"reason": {
"type": [
"string",
"null"
]
},
"expected_views_low": {
"type": [
"integer",
"null"
]
},
"expected_views_high": {
"type": [
"integer",
"null"
]
},
"on_sale": {
"type": "boolean"
}
},
"required": [
"id",
"creator",
"creator_id",
"unit_id",
"stage_id",
"stage",
"channel",
"channel_label",
"format",
"deliverable",
"scheduled_date",
"price_cents",
"review",
"vetting",
"reason",
"expected_views_low",
"expected_views_high",
"on_sale"
],
"additionalProperties": false
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/distribution-tech-campaign-created"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.