post https://backstage.taboola.com/backstage/api/1.0//campaigns//items/mass
Create a batch of items for a given campaign (using a single API request).
See also: Bulk create items across campaigns
Example
POST /backstage/api/1.0/demo-advertiser/campaigns/1234/items/mass
{
"collection": [{
"url": "https://www.demo-advertiser.com/wedding-rings",
"thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-1.jpg",
"title": "The perfect wedding ring"
},
{
"url": "https://www.demo-advertiser.com/proposal-rings",
"thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-2.jpg",
"title": "Amazing proposal rings"
},
{
"url": "https://www.demo-advertiser.com/medalions",
"thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-3.jpg",
"title": "Beautiful medallions"
}
]
}
{
"results": [
{
"id": "875",
"campaign_id": "1234",
"type": "ITEM",
"url": "https://www.demo-advertiser.com/wedding-rings",
"thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-1.jpg",
"title": "The perfect wedding ring",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"reject_reason_description": null,
"status_reason": null,
"reviewer_notes": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
},
"verification_pixel": null,
"viewability_tag": null,
"app_install": null,
"rating": null,
"logo": null,
"disclaimer": null,
"creative_crop": null,
"external_metadata": null
},
{
"id": "876",
"campaign_id": "1234",
"type": "ITEM",
"url": "https://www.demo-advertiser.com/proposal-rings",
"thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-2.jpg",
"title": "Amazing proposal rings",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"reject_reason_description": null,
"status_reason": null,
"reviewer_notes": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
},
"verification_pixel": null,
"viewability_tag": null,
"app_install": null,
"rating": null,
"logo": null,
"disclaimer": null,
"creative_crop": null,
"external_metadata": null
},
{
"id": "877",
"campaign_id": "1234",
"type": "ITEM",
"url": "https://www.demo-advertiser.com/medalions",
"thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-3.jpg",
"title": "Beautiful medallions",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"reject_reason_description": null,
"status_reason": null,
"reviewer_notes": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
},
"verification_pixel": null,
"viewability_tag": null,
"app_install": null,
"rating": null,
"logo": null,
"disclaimer": null,
"creative_crop": null,
"external_metadata": null
}
],
"metadata": {
"total": 0,
"count": 0,
"static_fields": [],
"static_total_fields": [],
"dynamic_fields": null,
"start_date": null,
"end_date": null
}
}
Request Object
collection: a collection of items to create.
Required fields (for each item passed)
Optional fields (for each item passed)
URL is not crawled
The endpoint saves the above values without crawling the URL. Make sure that the values passed are acceptable to Taboola.
Guidelines
- Use the
items/massendpoint, with a Campaign ID path param.- The
items/massendpoint is applicable for regular items only - not video items.- The new Items are created with a status of PENDING. Once approved, their status is updated to APPROVED.
See also: Bulk create items across campaigns (below).