Update an ad set

Ad-set-level writes. Use this for ABO budget updates, ad-set-scoped pause/resume, bid-strategy edits, and Meta-only post-launch delivery settings via platformSpecificData. At least one updatable field is required.

Bid strategy compatibility (per Meta's spec):

LOWEST_COST_WITHOUT_CAP: no bidAmount, no roasAverageFloor.
LOWEST_COST_WITH_BID_CAP / COST_CAP: bidAmount REQUIRED (whole currency units).
LOWEST_COST_WITH_MIN_ROAS: roasAverageFloor REQUIRED (decimal multiplier, e.g. 2.0 = 2.0x ROAS).

Delivery settings are validated by Meta against the campaign objective; incompatible combinations (e.g. a billingEvent the optimization goal doesn't allow) surface as 400s from Meta.

When updating budget on an ABO campaign: if the parent campaign is CBO, the response is 409 with code BUDGET_LEVEL_MISMATCH — route to PUT /v1/ads/campaigns/{campaignId} instead.

PlatformsMetaTikTok

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Path Parameters

adSetIdstring

Platform ad set ID

Request Body

platformstring

budget?

Omit if not updating budget

status?string

Omit if not toggling delivery state

Value in"active" | "paused"

name?string

Rename the ad set (Meta only; other platforms return 501). At least one of budget/status/bidStrategy/name is required.

Lengthlength <= 255

bidStrategy?string

Value in"LOWEST_COST_WITHOUT_CAP" | "LOWEST_COST_WITH_BID_CAP" | "COST_CAP" | "LOWEST_COST_WITH_MIN_ROAS"

bidAmount?number

Bid cap in WHOLE currency units (USD: 5 = $5.00; JPY: 100 = ¥100). Required when bidStrategy is LOWEST_COST_WITH_BID_CAP or COST_CAP. Internally converted to Meta's smallest-denomination integer, or (on OpenAI) to micros (× 1,000,000).

roasAverageFloor?number

Minimum ROAS as a decimal multiplier (2.0 = 2.0x). Required when bidStrategy is LOWEST_COST_WITH_MIN_ROAS. Sent to Meta as bid_constraints.roas_average_floor × 10000. Not supported on OpenAI (422).

platformSpecificData?

Platform-specific post-launch delivery settings. The platform is implied by the platform body param. Meta only; other platforms return 400. Unknown keys are rejected.

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adcampaigns.updateAdSet({  path: {    adSetId: 'adset_abc123',  },  body: {    platform: 'facebook',  },});console.log(data);

{
  "budget": {
    "amount": 0,
    "type": "daily"
  },
  "budgetLevel": "adset",
  "status": "active",
  "statusUpdated": 0,
  "statusSkipped": 0,
  "bidStrategy": "LOWEST_COST_WITHOUT_CAP",
  "bidAmount": 0,
  "roasAverageFloor": 0,
  "platformSpecificData": {}
}

Empty

{
  "error": "Unauthorized"
}

Empty

Update an ad set

Bid strategy compatibility (per Meta's spec):

LOWEST_COST_WITHOUT_CAP: no bidAmount, no roasAverageFloor.
LOWEST_COST_WITH_BID_CAP / COST_CAP: bidAmount REQUIRED (whole currency units).
LOWEST_COST_WITH_MIN_ROAS: roasAverageFloor REQUIRED (decimal multiplier, e.g. 2.0 = 2.0x ROAS).

Delivery settings are validated by Meta against the campaign objective; incompatible combinations (e.g. a billingEvent the optimization goal doesn't allow) surface as 400s from Meta.

When updating budget on an ABO campaign: if the parent campaign is CBO, the response is 409 with code BUDGET_LEVEL_MISMATCH — route to PUT /v1/ads/campaigns/{campaignId} instead.

PlatformsMetaTikTok

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Path Parameters

adSetIdstring

Platform ad set ID

Request Body

platformstring

budget?

Omit if not updating budget

status?string

Omit if not toggling delivery state

Value in"active" | "paused"

name?string

Rename the ad set (Meta only; other platforms return 501). At least one of budget/status/bidStrategy/name is required.

Lengthlength <= 255

bidStrategy?string

Value in"LOWEST_COST_WITHOUT_CAP" | "LOWEST_COST_WITH_BID_CAP" | "COST_CAP" | "LOWEST_COST_WITH_MIN_ROAS"

bidAmount?number

roasAverageFloor?number

platformSpecificData?

Platform-specific post-launch delivery settings. The platform is implied by the platform body param. Meta only; other platforms return 400. Unknown keys are rejected.

Response Body

application/json

import Zernio from '@zernio/node';

const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });

const { data } = await zernio.adcampaigns.updateAdSet({
  path: {
    adSetId: 'adset_abc123',
  },
  body: {
    platform: 'facebook',
  },
});
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adcampaigns.updateAdSet({  path: {    adSetId: 'adset_abc123',  },  body: {    platform: 'facebook',  },});console.log(data);

{
  "budget": {
    "amount": 0,
    "type": "daily"
  },
  "budgetLevel": "adset",
  "status": "active",
  "statusUpdated": 0,
  "statusSkipped": 0,
  "bidStrategy": "LOWEST_COST_WITHOUT_CAP",
  "bidAmount": 0,
  "roasAverageFloor": 0,
  "platformSpecificData": {}
}

Empty

{
  "error": "Unauthorized"
}

Empty

Update an ad set

200application/json

400

401application/json

404

409

422

501

Update an ad set

200application/json

400

401application/json

404

409

422

501

application/json

application/json

application/json

application/json