account | DynamicAccount | Yes | - | Select Meta Ads account to update ad sets in, ask the user for it if not provided |
update_type | string or SelectableOption | Yes | - | Choose whether to update a single ad set or multiple ad sets at once. Options: ‘single’ (Single Update), ‘bulk’ (Bulk Updates) |
adset_id | string or SelectItem | No | - | Select the ad set ID to update (required for single update) |
budget_type | string or SelectableOption | No | - | Select the budget type to update. Options: ‘daily_budget’ (Daily Budget), ‘lifetime_budget’ (Lifetime Budget) (required for single update) |
budget_value | number | No | - | The budget amount in the account currency exactly as shown in Ads Manager (e.g. 100 for 100,50.5for50.50, 300000 for COP 300,000); the backend applies Meta’s currency offset, never multiply yourself. Required for single update. IMPORTANT: budgets returned by meta_ads_get_adset_settings (daily_budget, lifetime_budget, etc.) are raw Meta minor units — divide by that row’s currency_offset (100 for most currencies, 1 for CLP, COP, CRC, HUF, ISK, IDR, JPY, KRW, PYG, TWD, VND) before passing here. |
structured_data | array (also accepts a comma-separated string) | No | - | Structured data with ‘adset_id’, ‘budget_type’, and ‘budget_value’ fields for each row (required for bulk update). ‘budget_value’ is the amount in the account currency as shown in Ads Manager (e.g. 100 = $100, 300000 = COP 300,000); the backend applies Meta’s currency offset. IMPORTANT: budgets returned by meta_ads_get_adset_settings are raw Meta minor units — divide by that row’s currency_offset (100 for most currencies, 1 for CLP, COP, CRC, HUF, ISK, IDR, JPY, KRW, PYG, TWD, VND) before passing here. |
