account | DynamicAccount | Yes | - | Select the X Ads account that owns the ad groups. |
update_type | string or SelectableOption | Yes | - | Choose whether to update a single ad group budget or multiple at once. Options: single or bulk. |
ad_group_id | string or SelectItem | No | - | X Ads ad group (line item) ID to update. Required for single update. |
budget_type | string or SelectableOption | No | {'value': 'daily', 'label': 'Daily'} | Which budget to update: daily (sent as daily_budget_amount_local_micro) or total (sent as total_budget_amount_local_micro). Default: daily. |
budget_value | number | No | - | New budget in the ad account’s currency (for example 50 for $50), converted to X micro-currency automatically. The daily budget must not exceed the ad group’s total budget. Required for single update. |
structured_data | array (also accepts a comma-separated string) | No | - | Use only when update_type is bulk. Required columns: ad_group_id and budget_value (account currency). Optional column: budget_type (daily or total; default daily). Up to 100 rows. |