Microsoft Advertising Write
Edit EXISTING ad groups — name, status (pause/resume), CPC/CPM/CPV/mCPA bids, bidding scheme, network, ad rotation, frequency caps, language, dates, URL tracking, bid adjustments, and predictive/optim
POST https://api.adspirer.ai/api/v1/tools/update_microsoft_ad_groups/execute
Authorization: Bearer sk_live_... — your Adspirer API key (required)Content-Type: application/json (required)Idempotency-Key: <uuid> — recommended for write operations to make retries safeAll tool arguments are wrapped in an arguments object.
| Field | Type | Description |
|---|---|---|
account_id | string optional | Microsoft Advertising ad account id (numeric AccountId — NOT the 8-character account number shown in the UI). Get it from list_microsoft_accounts. Required when more than one account is connected; may be omitted with exactly one. `customer_id` is accepted as an alias. If the tool replies that several accounts are connected, re-run with this set — that reply is NOT a connection problem. |
customer_id | string optional | Alias of account_id. |
campaign_id | string required | The parent campaign of the ad groups being edited (required). |
ad_groups | array required | Ad groups to edit. Each: {id (req), and any fields to change: name, status (pause/resume), cpc_bid/cpm_bid/cpv_bid/mcpa_bid (decimal account currency), bidding_scheme, network, ad_rotation_type, frequency_cap_settings, language ("" clears → inherit campaign), start_date/end_date ({Day,Month,Year}), tracking_url_template/final_url_suffix ("" clears), audience_ads_bid_adjustment, multimedia_ads_bid_adjustment, use_predictive_targeting, use_optimized_targeting}. ⛔ MERGE — omitted fields stay as-is. AdGroupType can't change. |
update_audience_bid_adjustment | boolean optional | Set true to actually apply audience_ads_bid_adjustment (Microsoft ignores that one field unless this flag is on). |
{
"arguments": {
"campaign_id": "<campaign_id>",
"ad_groups": [
{}
],
"account_id": "string",
"customer_id": "string",
"update_audience_bid_adjustment": false
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for update_microsoft_ad_groups)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "update_microsoft_ad_groups"
}
{
"success": false,
"error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n - Acme Holdings (ad_account_id=\"act_123456789\")\n - Acme EU (ad_account_id=\"act_987654321\")",
"is_error": true,
"tool": "update_microsoft_ad_groups"
}
{
"success": false,
"error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
"is_error": true,
"tool": "update_microsoft_ad_groups",
"quota": {
"used": 150,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01",
"upgrade_url": "https://adspirer.ai"
}
}
Interactive: Swagger UI
Machine-readable: OpenAPI 3.1 spec · llms-full.txt
More tools: Microsoft Advertising · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai