post
https://backstage.taboola.com/backstage/api/1.0//creatives/bulk
Create several creatives in one account in a single request. The operation is atomic: if any creative fails validation, no creatives are created.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Overview
Create several creatives in one account's Creative Library in a single request. Each creative in the collection follows the same rules as Create a creative.
POST /backstage/api/1.0/demo-advertiser/creatives/bulk{
"collection": [
{
"creative_type": "STATIC_IMAGE",
"name": "Summer sale hero 1",
"url": "https://www.demo-advertiser.com/summer-sale",
"thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/summer-sale-1.jpg",
"title": "Summer sale: up to 50% off"
},
{
"creative_type": "STATIC_IMAGE",
"name": "Summer sale hero 2",
"url": "https://www.demo-advertiser.com/summer-sale",
"thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/summer-sale-2.jpg",
"title": "New arrivals for summer"
}
]
}{
"elements": [
{
"value": {
"id": 4321000011,
"name": "Summer sale hero 1",
"account_id": "demo-advertiser",
"status": "ACTIVE",
"creative_type": "STATIC_IMAGE",
"url": "https://www.demo-advertiser.com/summer-sale",
"thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/summer-sale-1.jpg",
"title": "Summer sale: up to 50% off",
...
},
"error": null
},
{
"value": {
"id": 4321000012,
"name": "Summer sale hero 2",
"account_id": "demo-advertiser",
"status": "ACTIVE",
"creative_type": "STATIC_IMAGE",
"url": "https://www.demo-advertiser.com/summer-sale",
"thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/summer-sale-2.jpg",
"title": "New arrivals for summer",
...
},
"error": null
}
]
}{
"http_status": 400,
"message": "Missing required field",
"offending_field": "title"
}
Request object
collection- a list of creative objects to create. You can mix creative types in the same request.
Guidelines
- The operation is atomic: if any creative fails validation, no creatives are created and the error is returned for the whole request.
- The response is an
elementslist in the same order as the request. Each element has the created creative invalueanderror=null.- The new creatives are unassigned. To create ads from them, see Assigning creatives to campaigns.
- All creatives are created in the account in the path. To create creatives across several accounts, use Bulk upsert creatives.
- Creative consolidation applies to each creative: a creative identical to an existing one returns the existing creative, and creatives identical to each other within the request result in a single creative.
See also
- Bulk creative operations - how the 3 bulk endpoints differ.
- Bulk upsert creatives
- Bulk delete creatives