Skip to main content
POST
Adopt a managed audio 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 audio source.

source_uid
string<uuid>
required

Opaque owner-scoped reference returned when the managed audio 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

Associate the manifest to this campaign in the same call. Audio adoption does not start seller or destination sync.

Required string length: 1 - 64

Response

Adopt a managed audio source into a creative

Result of adopting a managed audio source into a creative.

creative_id
string
required

Creative manifest that now carries the managed audio.

source_uid
string<uuid>
required

The managed audio 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 creative name.

created
boolean
required

True only when this call created the creative. A successful campaign association writes the manifest membership only; it does not start seller or destination sync.

campaign_id
string

A campaign the manifest is associated with. Returned when requested, and on a replay when a membership already exists. This association does not start seller or destination sync.