curl --request POST \
--url https://api.interchange.io/api/v2/buyer/creatives/adopt-managed-audio-source \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"advertiser_id": "<string>",
"storefront_id": "<string>",
"name": "<string>"
}
'import requests
url = "https://api.interchange.io/api/v2/buyer/creatives/adopt-managed-audio-source"
payload = {
"source_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"advertiser_id": "<string>",
"storefront_id": "<string>",
"name": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
source_uid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
advertiser_id: '<string>',
storefront_id: '<string>',
name: '<string>'
})
};
fetch('https://api.interchange.io/api/v2/buyer/creatives/adopt-managed-audio-source', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"creative_id": "<string>",
"source_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publication_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"delivery_url": "<string>",
"name": "<string>",
"created": true,
"campaign_id": "<string>"
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Adopt a managed audio source into a creative
Adopt a promoted managed audio source into an audio-hosted creative manifest. The bounded hosted HTTPS URL is issued server-side, so the caller names a source rather than a URL. The operation requires both the managed-audio account capability and bounded delivery-origin gate to be explicitly enabled; this change enables neither. Optionally records a non-delivery campaign association; it does not assign a media buy or call a destination.
curl --request POST \
--url https://api.interchange.io/api/v2/buyer/creatives/adopt-managed-audio-source \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"advertiser_id": "<string>",
"storefront_id": "<string>",
"name": "<string>"
}
'import requests
url = "https://api.interchange.io/api/v2/buyer/creatives/adopt-managed-audio-source"
payload = {
"source_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"advertiser_id": "<string>",
"storefront_id": "<string>",
"name": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
source_uid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
advertiser_id: '<string>',
storefront_id: '<string>',
name: '<string>'
})
};
fetch('https://api.interchange.io/api/v2/buyer/creatives/adopt-managed-audio-source', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"creative_id": "<string>",
"source_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"publication_uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"delivery_url": "<string>",
"name": "<string>",
"created": true,
"campaign_id": "<string>"
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Authorizations
API key or access token
Body
Create or adopt a Creative Manifest from a promoted managed audio source.
Opaque owner-scoped reference returned when the managed audio source was promoted.
^([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 that owns the source and will own the creative. A positive integer within the signed 64-bit range.
^[1-9][0-9]*$Storefront the source was uploaded against. A positive integer within the signed 64-bit range.
^[1-9][0-9]*$Buyer-facing creative name.
1 - 255Associate the manifest to this campaign in the same call. Audio adoption does not start seller or destination sync.
1 - 64Response
Adopt a managed audio source into a creative
Result of adopting a managed audio source into a creative.
Creative manifest that now carries the managed audio.
The managed audio source that was adopted.
^([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)$Bounded hosted publication backing the creative asset. Revoking it revokes delivery.
^([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)$Public HTTPS URL stored as the creative asset. Expires with the source retention window.
Buyer-facing creative name.
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.
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.