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. |