Create creative manifest

POST /api/v2/buyer/campaigns/{campaignId}/creatives/create Creates a manifest from uploaded files plus JSON metadata in a single multipart/form-data request. Scope3 auto-classifies assets, processes HTML to rewrite local references to CDN URLs, inserts ADCP tracking macros, and generates a preview. The body is a metadata JSON part plus zero or more files parts; each file pairs with the matching assets[].filename.

Propagation to sales agents is asynchronous. On campaign execute, the manifest syncs to each agent that supports its format as a creative_sync task — poll sync_status to confirm receipt. See Tasks for the async polling model.

Request

curl -X POST https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/creatives/create \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F 'metadata={
    "name": "Q2 hero video",
    "message": "30s product reveal — premium tone, 2-second hook",
    "template_id": "video_standard",
    "url_asset": { "url": "https://acme.com/promo", "url_type": "clickthrough" },
    "assets": [
      { "filename": "hero-30s.mp4", "asset_type": "VIDEO", "label": "main_video" }
    ]
  };type=application/json' \
  -F "files=@hero-30s.mp4" \
  -F "files=@companion-banner.png"

curl -X POST https://api.interchange.io/api/v2/buyer/campaigns/cmp_987654321/creatives/create \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F 'metadata={
    "name": "VAST premium",
    "template_id": "video_vast",
    "url_asset": { "url": "https://ad.doubleclick.net/ddm/vast/acme", "url_type": "vast" }
  };type=application/json'

Parameters

The metadata JSON part carries:

Field	Type	Required	Notes
`name`	string	No	Manifest name (max 255). Auto-generated if omitted
`message`	string	No	Creative brief / direction text (max 5000)
`template_id`	string	No	ADCP format ID (`display_image`, `display_html`, `video_standard`) or vendor tag
`format_id`	object	No	`{ agent_url, id, width?, height?, duration_ms? }` — explicit ADCP format reference
`format_kind`	string	No	AdCP 3.1 canonical kind (e.g. `image_carousel`, `video_hosted`). Alternative to `format_id`
`format_option_ref`	object	No	Pins an exact canonical option. Use `{ scope: "product", format_option_id }` for an option declared by a campaign product, or `{ scope: "publisher", publisher_domain, format_option_id }` for a publisher catalog option. A product pin resolves and returns its declared `format_kind`
`url_asset`	object	No	Single URL asset: `{ url, url_type }`. `url_type` is `clickthrough`, `tracker_pixel`, `tracker_script`, or `vast`
`url_assets`	array	No	Slot-bound URL assets for multi-slot formats (max 50): `{ asset_id, url, url_type? }`
`text_assets`	array	No	Slot-bound text assets, e.g. native headline (max 50): `{ asset_id, content }`
`assets`	array	No	Per-file metadata: `{ filename, asset_type?, label?, slot_asset_id? }`. `asset_type` is one of `IMAGE`, `VIDEO`, `AUDIO`, `HTML`, `JAVASCRIPT`, `CSS`, `TEXT`, `URL`, `VAST`, `FONT`, `LOGO`, `DOCUMENT`. Auto-classified if omitted
`cards`	array	No	Carousel cards for `image_carousel` (2–10): `{ filename` or `url, headline?, description?, cta?, landing_page_url? }`
`frequencyCaps`	array	No	Buyer-defined caps: `{ max_impressions, window: { interval, unit } }`

Form parts: files=@<path> (one per uploaded asset). Limits: 50 MB per file, 20 files per request.

Response

{
  "creative_id": "cm_abcdef",
  "campaign_id": "cmp_987654321",
  "name": "Q2 hero video",
  "message": "30s product reveal — premium tone, 2-second hook",
  "template_id": "video_standard",
  "brand_domain": "acme.com",
  "format_id": { "id": "video_standard", "agent_url": "https://agent.example.com" },
  "preview_url": "https://storage.googleapis.com/creatives/cm_abcdef/preview.html",
  "assets": [
    {
      "asset_id": "asset_001",
      "name": "main_video",
      "original_filename": "hero-30s.mp4",
      "asset_type": "VIDEO",
      "content_type": "video/mp4",
      "file_size": 8421376,
      "public_url": "https://cdn.example.com/creatives/cm_abcdef/hero-30s.mp4",
      "asset_source": "USER_UPLOADED",
      "created_at": "2026-06-07T15:04:00Z"
    }
  ],
  "tracking": {
    "impression_tracker_url": "https://track.scope3.com/imp?cid={CAMPAIGN_ID}",
    "click_tracker_url": "https://track.scope3.com/clk?rurl=https%3A%2F%2Facme.com%2Fpromo",
    "supported_macros": ["CAMPAIGN_ID", "DEVICE_TYPE", "COUNTRY"]
  },
  "sync_status": { "synced": false, "agent_count": 0 },
  "created_at": "2026-06-07T15:04:00Z",
  "updated_at": "2026-06-07T15:04:00Z"
}

Returns 201. sync_status.synced is false until the campaign executes and the manifest propagates. When a manifest with the same (campaign_id, name) already exists, the existing one is returned with already_exists: true and ignored_files set — use Update creative manifest to add assets to it.

Errors

400 VALIDATION_ERROR — a files part with no matching assets[].filename, more than one url_type: clickthrough URL asset, file over 50 MB, or unsupported MIME type.
400 VALIDATION_ERROR — a product-scoped format_option_ref is missing from the campaign, conflicts across campaign products, or disagrees with an explicit format_kind.
404 NOT_FOUND — campaignId does not exist or is not visible to the authenticated account.

See Errors for the full error contract.

Creative overview

Manifest fields, asset types, and tracking

Get creative manifest

Read the created manifest

Tasks

Async creative_sync polling

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Creative overview

Get creative manifest

Tasks

​Request

​Parameters

​Response

​Errors

​Related

Creative overview

Get creative manifest

Tasks

Request

Parameters

Response

Errors

Related