Update Ad Group Status

Activates, pauses, or permanently deletes X (Twitter) Ads ad groups (line items), one or many at once

Activates, pauses, or permanently deletes X (Twitter) Ads ad groups (line items), one or many at once. DELETED cannot be undone.

App	X Ads
Operation ID	x_ads_update_ad_group_status
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 groups.
update_type	string or SelectableOption	Yes	-	Choose whether to update a single ad group 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.
status	string or SelectableOption	No	-	New ad group status: ACTIVE, PAUSED, or DELETED. DELETED permanently deletes the ad group via the X DELETE endpoint and cannot be undone. 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 status (ACTIVE, PAUSED, or DELETED; DELETED permanently deletes). Up to 100 rows.

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.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: String

Returns a summary of how many ad groups were updated.