Update a Campaign Group

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Overview

Update an existing campaign group. Submit a JSON object representing the fields to update. Both POST and PUT are supported with identical behavior.

📘
Guidelines

Either POST or PUT works. The examples below use POST.

Submit only the fields you want to change. Fields that are omitted or set to null are not modified.

Example - Update a single field

POST /backstage/api/1.0/taboola-demo-advertiser/campaigns_group/124

{
  "name": "Demo Campaign Group - Edited"
}

{
  "id": 124,
  "account_id": "taboola-demo-advertiser",
  "name": "Demo Campaign Group - Edited",
  "language": "en",
  "daily_cap": 0.0,
  "spending_limit": 1000,
  "spending_limit_model": "MONTHLY",
  "start_date": "2023-04-24",
  "start_date_in_utc": "2023-04-24 00:00:00",
  "end_date": "9999-12-31",
  "end_date_in_utc": "9999-12-31 23:59:59",
  "is_active": true,
  "bid_strategy": "FIXED",
  "status": "RUNNING",
  "daily_ad_delivery_model": "BALANCED",
  "marketing_objective": "MOBILE_APP_INSTALL"
}

Example - Update multiple fields

POST /backstage/api/1.0/taboola-demo-advertiser/campaigns_group/124

{
  "name": "Demo Campaign Group",
  "daily_cap": 500,
  "spending_limit": 5000,
  "spending_limit_model": "ENTIRE",
  "start_date": "2023-04-24",
  "end_date": "2023-05-24"
}

{
  "id": 123,
  "name": "Demo Campaign Group",
  "daily_cap": 500,
  "spending_limit": 5000,
  "spending_limit_model": "ENTIRE",
  "start_date": "2023-04-24",
  "end_date": "2023-05-24",
  "status": "RUNNING",
  ...
}

Example - Pause a campaign group

Setting is_active to false pauses the group. The status field flips to PAUSED.

POST /backstage/api/1.0/taboola-demo-advertiser/campaigns_group/124

{
  "is_active": false
}

{
  "id": 124,
  "name": "Demo Campaign Group",
  "is_active": false,
  "status": "PAUSED",
  ...
}