| App | Microsoft Ads |
| Operation ID | microsoft_ads_update_ad_group_status |
| Type | Action |
| Connection | microsoft_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Requires approval | Yes (write operation) |
Inputs
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
account | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes | - | Select the Microsoft Ads account to update ad groups in. |
update_type | string or SelectableOption | Yes | - | Choose whether to update a single ad group or multiple ad groups at once. Options: ‘single’ or ‘bulk’. |
campaign_id | string or SelectItem | No | - | Select the campaign that contains the ad group. Required for single update. |
ad_group_id | string or SelectItem | No | - | Select the ad group ID to update. Required for single update. |
ad_group_status | string or SelectableOption | No | - | Select the new ad group status. Options: ACTIVE, PAUSED, or DELETED. Required for single update. |
structured_data | array (also accepts a comma-separated string) | No | - | Structured data with ‘campaign_id’, ‘ad_group_id’, and ‘status’ fields for each row. Required for bulk update. |
MicrosoftAdsAccountItem
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - | |
customerId | string | No | - | The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID. |
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:Dict
Returns Microsoft Ads ad group status update results.
Fields: message, updated_count, results