Meta Ads / API Reference
meta_ads_switch_budget_mode
Meta Ads tool. Switch a Meta Ads campaign between CBO (Campaign Budget Optimization) and ad-set-level budgets. CBO mode: budget is set at the campaign level and Meta distributes it automatically across ad sets. Ad-set mode: each ad set controls its own budget independently. When switching FROM CBO to ad-set mode: Meta clears ad set budgets during the switch. Call meta_ads_update_adset_budget for each ad set afterward to restore their budgets. The response includes the list of ad sets so you know which ones to update. When switching FROM ad-set to CBO mode: pass campaign_daily_budget or campaign_lifetime_budget to set the new campaign-level budget in the same call. Args: campaign_id: Campaign ID to switch (required). mode: Target mode — 'cbo' to enable campaign-level budget, 'adset' to use per-ad-set budgets (required). account_id: Ad account ID. Leave blank to use .env default. campaign_daily_budget: Daily budget in smallest currency unit to set when enabling CBO, e.g. '10000' for ₪100. campaign_lifetime_budget: Lifetime budget in smallest currency unit to set when enabling CBO.
This is a read-only tool: it returns switch budget mode for your Meta Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Switch budget mode in my Meta Ads account for [campaign id], [mode].
It takes 2 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | Yes | Campaign Id |
mode | string | Yes | Mode |
account_id | string | No | Account Id |
campaign_daily_budget | string | No | Campaign Daily Budget |
campaign_lifetime_budget | string | No | Campaign Lifetime Budget |
Related Meta Ads tools
meta_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnosticsmeta_ads_account_spending_limitmeta_ads_admeta_ads_ad_account
Before you can call it
This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: