Skip to main content
POST
Adopt a managed video source into a creative

Authorizations

Authorization
string
header
required

API key or access token

Body

application/json

Create or adopt a Creative Manifest from a promoted managed video source.

source_uid
string<uuid>
required

Opaque owner-scoped reference returned when the managed video source was promoted.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
advertiser_id
string
required

Advertiser that owns the source and will own the creative. A positive integer within the signed 64-bit range.

Pattern: ^[1-9][0-9]*$
storefront_id
string
required

Storefront the source was uploaded against. A positive integer within the signed 64-bit range.

Pattern: ^[1-9][0-9]*$
name
string
required

Buyer-facing creative name.

Required string length: 1 - 255
campaign_id
string

Attach the creative to this campaign in the same call. This confirms campaign attachment only — the campaign's live media-buy packages are synced to sellers in the background, and that sync is not part of what the response confirms. Omit to leave the creative advertiser-scoped.

Required string length: 1 - 64

Response

Adopt a managed video source into a creative

Result of adopting a managed video source into a creative.

creative_id
string
required

Creative manifest that now carries the managed video.

source_uid
string<uuid>
required

The managed video source that was adopted.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
publication_uid
string<uuid>
required

Bounded hosted publication backing the creative asset. Revoking it revokes delivery.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
delivery_url
string
required

Public HTTPS URL stored as the creative asset. Expires with the source retention window.

name
string
required

Buyer-facing name of the creative. Adoption never renames an existing creative, so a replay returns the name it already had.

created
boolean
required

True only when this call created the creative. False means an existing adoption for this source was returned. Either way, a 2xx response with a requested campaign_id means the creative is attached to that campaign — not that sellers have accepted it into their media-buy packages, which sync in the background and are not confirmed here. Attachment is idempotent, so a retry finishes an attachment an earlier call left undone.

campaign_id
string

A campaign the creative is attached to. Returned when the request named one, and on a replay when the creative is already attached to at least one campaign.