Remove a Microsoft Advertising ad group
msads_remove_ad_groupPermanently delete an ad group, along with its keywords and ads. This cannot be undone and its history stays only in reports. Safety checks: the ad group must already be Paused (use msads_set_status first, so you never delete something that is serving), and confirmName must match the ad group's name exactly. To stop an ad group without losing it, pause it instead. Always run dryRun first: it shows what would be deleted (keyword and ad counts).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"campaignId": "<campaignId>",
"adGroupId": "<adGroupId>",
"confirmName": "<confirmName>"
},
"name": "msads_remove_ad_group"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dryRun | No | Preview only. Microsoft has no validate-only mode, so Caybl reads the current value and shows exactly what would change (before and after) without sending anything. Free, and cannot affect spend. | |
| accountId | No | Microsoft Advertising account id or account number (e.g. 'F123ABCD'), as listed by msads_list_accounts. Only needed when the sign-in can reach more than one account. | |
| adGroupId | Yes | Ad group id, from msads_get_ad_groups. | |
| campaignId | Yes | Campaign id, from msads_get_campaigns. | |
| confirmName | Yes | The ad group's exact name, typed back to confirm the deletion. |