Update Ad Group Bid - Markifact

Update the bid (CPC, CPM, CPV, and other bid types) of Microsoft Ads ad groups.


App	Microsoft Ads
Operation ID	`microsoft_ads_update_ad_group_bid`
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 that owns the ad groups to update.
`update_type`	string or SelectableOption	Yes	-	Choose whether to update the bid of a single ad group or multiple ad groups at once. Options: ‘single’ or ‘bulk’.
`campaign_id`	string or SelectItem	No	-	The campaign ID that contains the ad group. Required for single update (ad group updates are scoped to their campaign).
`ad_group_id`	string or SelectItem	No	-	The ad group ID whose bid to update. Required for single update.
`bid_type`	string or SelectableOption	No	-	Which ad group bid to set, sent as the Microsoft technical field name. ‘CpcBid’: default max cost-per-click (Search/Shopping). ‘CpmBid’: max cost-per-thousand-impressions (Audience/display). ‘CpvBid’: max cost-per-view (video). ‘McpaBid’: manual cost-per-action. ‘PercentCpcBid’: percent-of-price CPC for hotel campaigns. ‘CommissionRate’: commission rate for hotel commission campaigns. Required for single update.
`bid_amount`	number or string	No	-	New bid amount as a plain number. For CpcBid/CpmBid/CpvBid/McpaBid it is an amount in the account currency (e.g. 2.5). For PercentCpcBid/CommissionRate it is a percentage. Required for single update.
`structured_data`	array (also accepts a comma-separated string)	No	-	Structured data for bulk update. Required columns: ‘campaign_id’, ‘ad_group_id’, ‘bid_type’, ‘bid_amount’. 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 bid update results. Fields: message, updated_count, results