Update a campaign

Campaign-level edits. Send at least one of budget, bidStrategy, name or platformSpecificData. An unsupported field is always an error, never a silent drop.

Body field	Meta	Google	Others
`bidStrategy`	Yes	Yes	501
`bidAmount`, `roasAverageFloor`	400 — ad-set level	Yes	400
`budget` (CBO; ABO returns 409)	Yes	501	501
`name`	Yes	501	501
`platformSpecificData.spendCap`	Yes	400	400
`accountId` (empty campaigns)	Yes	-	-

Google maps the shared enum onto its own strategies: LOWEST_COST_WITHOUT_CAP to Maximize Clicks, LOWEST_COST_WITH_BID_CAP to Maximize Clicks with a max CPC (bidAmount), COST_CAP to Target CPA (bidAmount), LOWEST_COST_WITH_MIN_ROAS to Target ROAS (roasAverageFloor). A campaign on a PORTFOLIO bidding strategy is rejected: detach it in Google Ads first, since it is shared across campaigns.

accountId forwards the update straight to Meta for a campaign with zero ads, which would otherwise 404; the response then carries updated: 0.

PlatformsMetaGoogle

Authorization

AuthorizationBearer <token>

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

In: header

Path Parameters

campaignIdstring

Platform campaign ID

Request Body

platformstring

Required: platform campaign IDs are not globally unique.

Value in"facebook" | "instagram" | "google"

accountId?string

Meta only. Zernio SocialAccount id owning the ad account. Needed only for an EMPTY campaign (zero ads); ignored otherwise.

bidStrategy?string

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

bidAmount?number

Google only. Whole currency units (USD: 12 = $12.00). Max CPC for LOWEST_COST_WITH_BID_CAP, CPA target for COST_CAP; required for both.

roasAverageFloor?number

Google only. Decimal ROAS multiplier (2.0 = 2.0x), required for LOWEST_COST_WITH_MIN_ROAS.

budget?

Meta only. The CBO budget.

name?string

Meta only. Rename the campaign.

Lengthlength <= 255

platformSpecificData?

Meta only. Platform implied by the platform body param, same convention as POST /v1/ads/create.

Response Body

application/json

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

{
  "updated": 0,
  "budget": {
    "amount": 0,
    "type": "daily"
  },
  "budgetLevel": "campaign",
  "bidStrategy": "LOWEST_COST_WITHOUT_CAP",
  "bidAmount": 0,
  "roasAverageFloor": 0,
  "platformSpecificData": {}
}

Empty

{
  "error": "Unauthorized"
}

Empty

Update a campaign

Campaign-level edits. Send at least one of budget, bidStrategy, name or platformSpecificData. An unsupported field is always an error, never a silent drop.

Body field	Meta	Google	Others
`bidStrategy`	Yes	Yes	501
`bidAmount`, `roasAverageFloor`	400 — ad-set level	Yes	400
`budget` (CBO; ABO returns 409)	Yes	501	501
`name`	Yes	501	501
`platformSpecificData.spendCap`	Yes	400	400
`accountId` (empty campaigns)	Yes	-	-

accountId forwards the update straight to Meta for a campaign with zero ads, which would otherwise 404; the response then carries updated: 0.

PlatformsMetaGoogle

Authorization

AuthorizationBearer <token>

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

In: header

Path Parameters

campaignIdstring

Platform campaign ID

Request Body

platformstring

Required: platform campaign IDs are not globally unique.

Value in"facebook" | "instagram" | "google"

accountId?string

Meta only. Zernio SocialAccount id owning the ad account. Needed only for an EMPTY campaign (zero ads); ignored otherwise.

bidStrategy?string

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

bidAmount?number

Google only. Whole currency units (USD: 12 = $12.00). Max CPC for LOWEST_COST_WITH_BID_CAP, CPA target for COST_CAP; required for both.

roasAverageFloor?number

Google only. Decimal ROAS multiplier (2.0 = 2.0x), required for LOWEST_COST_WITH_MIN_ROAS.

budget?

Meta only. The CBO budget.

name?string

Meta only. Rename the campaign.

Lengthlength <= 255

platformSpecificData?

Meta only. Platform implied by the platform body param, same convention as POST /v1/ads/create.

Response Body

application/json

import Zernio from '@zernio/node';

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

const { data } = await zernio.adcampaigns.updateAdCampaign({
  path: {
    campaignId: 'campaign_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.updateAdCampaign({  path: {    campaignId: 'campaign_abc123',  },  body: {    platform: 'facebook',  },});console.log(data);

{
  "updated": 0,
  "budget": {
    "amount": 0,
    "type": "daily"
  },
  "budgetLevel": "campaign",
  "bidStrategy": "LOWEST_COST_WITHOUT_CAP",
  "bidAmount": 0,
  "roasAverageFloor": 0,
  "platformSpecificData": {}
}

Empty

{
  "error": "Unauthorized"
}

Empty

Update a campaign

200application/json

400

401application/json

404

409

501

Update a campaign

200application/json

400

401application/json

404

409

501

application/json

application/json

application/json

application/json