Documentation menu
Ads

Update campaign

Change a Meta campaign's name, budget, bid strategy or spend cap.

PATCHhttps://app.tryadeli.com/api/v1/ads/campaigns/{campaignId}
AuthorizationBearer <API key>How keys work

Meta Ads. Renames a campaign, or changes its Advantage campaign budget (CBO), bid strategy or spend cap. Only the fields you send change. The campaign must belong to adAccountId, or the response is 404 object_not_found.

A campaign that budgets each ad set has no budget or bid strategy of its own: sending either returns 400 invalid_request, and they change on the ad set with Update ad group. A budget keeps the type the campaign has, because Meta does not switch daily and lifetime budgets.

Body

adAccountIdstringRequired
The ad account the campaign belongs to.
namestring
Shown in Ads Manager.
budgetobject
{ type: daily | lifetime, amount } in whole currency units. CBO campaigns only.
bidStrategystring
lowest_cost, bid_cap, cost_cap or min_roas. CBO campaigns only; amounts and ROAS floors stay on each ad set.
spendCapnumber | null
Whole currency units: the most the campaign may ever spend. null removes the cap. Meta's minimum is about 100 USD.
confirmLargeChangeboolean
true once the user has confirmed a budget increase of more than 50%.

Raising a budget on a running campaign spends more as soon as Meta applies it.

Limits on changes

Adeli paces Meta Ads changes so an ad account driven by an agent does not look automated to Meta:

  • Changes to one ad account are spaced a couple of seconds apart. When too many are queued, the response is 429 ads_change_limited with Retry-After.
  • A status or budget equal to the current one succeeds without calling Meta.
  • One object's status, or its budget, can change four times an hour. The fifth change answers 429 ads_change_limited.
  • A budget increase of more than 50% answers 409 confirmation_required with the old and new amounts. Confirm the amount with the user, then send it again with confirmLargeChange: true. Decreases are never held back.
  • 422 ads_writes_paused means Adeli has paused ad changes for the workspace.