update_payload | object or string | Yes | - | Ad group fields to update as a JSON object; only the fields you include are changed, and a null value unsets an optional attribute. Editable fields per the X Ads docs: name, entity_status (ACTIVE or PAUSED), start_time and end_time (ISO 8601), bid_strategy (AUTO, MAX, TARGET), bid_amount_local_micro (raw micro-currency integer, required for MAX or TARGET), goal, pay_by, daily_budget_amount_local_micro, total_budget_amount_local_micro, standard_delivery (true = even pacing), frequency_cap with duration_in_days (1, 7, or 30), audience_expansion (BROAD, DEFINED, EXPANDED), categories, advertiser_domain, android_app_store_identifier, ios_app_store_identifier, and primary_web_event_tag. Prefer the dedicated operations for plain changes: x_ads_update_ad_group_status, x_ads_rename_ad_group, x_ads_update_ad_group_budget. Example: {“bid_strategy”: “MAX”, “bid_amount_local_micro”: 2000000, “end_time”: “2026-09-30T00:00:00Z”} |