Skip to main content
POST
/
campaigns
/
{campaignId}
/
creatives
/
create
Create creative manifest
curl --request POST \
  --url https://api.interchange.io/api/v2/buyer/campaigns/{campaignId}/creatives/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "creative_id": "<string>",
  "name": "<string>",
  "assets": [
    {
      "asset_id": "<string>",
      "name": "<string>",
      "original_filename": "<string>",
      "asset_type": "IMAGE",
      "content_type": "<string>",
      "file_size": 0,
      "public_url": "<string>",
      "asset_source": "CREATIVE_SOURCE",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "campaign_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "message": "<string>",
  "brand_domain": "<string>",
  "template_id": "<string>",
  "format_id": {
    "id": "<string>",
    "agent_url": "<string>",
    "width": 123,
    "height": 123,
    "duration_ms": 123
  },
  "target_format_ids": [
    {
      "id": "<string>",
      "agent_url": "<string>",
      "width": 123,
      "height": 123,
      "duration_ms": 123
    }
  ],
  "preview_url": "<string>",
  "html_processing": {
    "rewritten_refs": [
      {
        "original": "<string>",
        "cdn_url": "<string>"
      }
    ],
    "unresolved_refs": [
      "<string>"
    ],
    "inserted_macros": [
      "<string>"
    ],
    "processed_html": "<string>",
    "processed_html_url": "<string>"
  },
  "auto_detected_template": {
    "template_id": "<string>",
    "template_name": "<string>",
    "method": "tag_hints"
  },
  "creative_manifest": "<unknown>",
  "sync_status": {
    "synced": true,
    "agent_count": 0,
    "last_synced_at": "2023-11-07T05:31:56Z"
  },
  "tracking": {
    "supported_macros": [
      "<string>"
    ],
    "impression_tracker_url": "<string>",
    "click_tracker_url": "<string>"
  },
  "frequencyCaps": [
    {
      "max_impressions": 3,
      "window": {
        "interval": 123,
        "unit": "seconds"
      },
      "id": "12345",
      "targetLevel": "ADVERTISER",
      "targetId": "camp_abc123",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "archivedAt": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.interchange.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

campaignId
string
required

Campaign ID

Minimum string length: 1

Body

application/json

JSON metadata for creating a creative manifest

name
string

Manifest name (auto-generated if omitted)

Required string length: 1 - 255
message
string

Creative brief / direction text

Required string length: 1 - 5000
url_asset
object

Add a URL asset (per AdCP url-asset spec). Requires url_type.

webhook_asset
object

Add a webhook asset for DCO (dynamic content).

format_id
object
template_id
string

Creative template ID — ADCP format ID (e.g., "display_image", "display_html", "video_standard") or vendor tag (e.g., "vendor_dcm_tag")

assets
object[]

Metadata for uploaded files. If omitted, all uploaded files are auto-classified.

frequencyCaps
object[]

Buyer-defined frequency caps for this creative. When provided, sets the full list.

Response

Create creative manifest

Creative manifest with inline assets

creative_id
string
required

Creative manifest ID

name
string
required

Manifest name

assets
object[]
required

Uploaded assets in this manifest

campaign_id
string
required

Campaign ID

created_at
string<date-time>
required

Created timestamp

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
updated_at
string<date-time>
required

Updated timestamp

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
message
string

Creative brief text

brand_domain
string

Brand domain (auto-resolved)

template_id
string

Creative template used for this manifest

format_id
object
target_format_ids
object[]

Target format IDs (from campaign products)

preview_url
string<uri>

URL to preview the processed creative (processed HTML hosted in GCS)

html_processing
object

Result of HTML processing (CDN URL rewriting + macro insertion)

auto_detected_template
object

Auto-detected template info (populated when template_id was not explicitly provided)

creative_manifest
any

Full ADCP creative manifest (built for sync)

sync_status
object

Sync status across sales agents

tracking
object

Auto-generated Scope3 tracking URLs for impression and click measurement

frequencyCaps
object[]

Buyer-defined frequency caps configured for this creative