Promote advertiser creatives into the library shelf
Buyer-creative-v2 (feature-flagged). Promotes advertiser creatives into the durable creative library (“the shelf”) with a role — evergreen (serve-ready, reusable across campaigns) or reference (a generation input, not served). Identify the creatives by creative_ids or by collection_id. No campaign is required. Returns 404 for callers not enrolled in the flag.
Authorizations
API key or access token
Path Parameters
Advertiser ID
1Body
Promote advertiser creatives into the library ("the shelf") with a role. Identify the creatives by creative_ids or by collection_id.
Library role to assign: evergreen (serve-ready) or reference (generation input).
evergreen, reference Creative manifest IDs to promote into the advertiser library. Provide this or collection_id.
1A saved collection (e.g. the one grouped at creative-intent time) whose creative members are all promoted. Provide this or creative_ids — collection_id scales to any number of creatives.
1Response
Promote advertiser creatives into the library shelf
Result of promoting creatives into the advertiser library.
Advertiser creative-library role: evergreen (serve-ready, reusable across campaigns) or reference (a generation input, not served). Absent for flight-specific creatives.
evergreen, reference Creative manifest IDs whose role was set.
The advertiser library after the save (promoted creatives only), so the result can render the shelf.
Total promoted creatives in the advertiser library.
0 <= x <= 9007199254740991