Update Ad Group

Updates an X (Twitter) Ads ad group (line item) with a raw fields payload; only provided fields are changed

Updates an X (Twitter) Ads ad group (line item) with a raw fields payload; only provided fields are changed. Covers bidding, goals, budgets, schedule, pacing, frequency caps, and app identifiers. Prefer the dedicated status/rename/budget operations for plain changes.

App	X Ads
Operation ID	x_ads_update_ad_group
Type	Action
Connection	x_ads (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
account	DynamicAccount	Yes	-	Select the X Ads account that owns the ad group.
ad_group_id	string or SelectItem	Yes	-	X Ads ad group (line item) ID to update. Do not repeat it inside update_payload.
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”}
dry_run	boolean	No	False	When true, do not call X. Return the resolved request parameters for review.

SelectItem

Field	Type	Required	Default	Description
value	string	Yes	-	The value of the selectable item.
label	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

Output

Type: Dict

Returns the updated fields, resolved request parameters, and the updated ad group object.

Fields: dynamic (depend on the inputs)