Activate or Deactivate Campaign Groups (Bulk)

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Overview

Activate or deactivate up to 1,000 campaign groups in a single request. The endpoint accepts a list of ActivationEntity objects.

The optional is_atomic query parameter (default true) controls how failures are handled:

`is_atomic`	Behavior
`true`	The entire batch is rejected on any single entity failure.
`false`	Failed entities are skipped; successful entities are still applied.

The response is the list of successfully-updated campaign groups.

ActivationEntity fields

Field	Modifier	Type	Description
`id`	Required	Long	Unique ID of the entity (account or campaign group).
`is_active`	Required	Boolean	Requested state after the action.
`entity_type`	Required	Enum	One of: `ADVERTISER`, `CAMPAIGNS_GROUP`.

Failure behavior reference

Case	`is_atomic: true`	`is_atomic: false`
User lacks batch activation permission	Forbidden	Forbidden
User not allowed on at least one entity's account	Forbidden	Forbidden
Entity is missing required fields	Missing Field	Skips entity
Entity not found	Not Found	Skips entity
Activating a stopped entity	Bad Request	Skips entity

Example - Activate multiple entities

POST /backstage/api/1.0/entities/activations?is_atomic=true

{
  "collection": [
    { "id": 123123, "is_active": true, "entity_type": "ADVERTISER" },
    { "id": 34123,  "is_active": true, "entity_type": "CAMPAIGNS_GROUP" }
  ]
}

{
  "collection": [
    { "id": 123123, "is_active": true, "entity_type": "ADVERTISER" },
    { "id": 34123,  "is_active": true, "entity_type": "CAMPAIGNS_GROUP" }
  ],
  "metadata": {}
}

Failure response

{
  "http_status": 400,
  "message": "Missing required field",
  "offending_field": "entity_type",
  "message_code": "api.action.bad_request.entityType"
}