Update Conversion Goal

Update a Microsoft Ads conversion goal: rename it, change its attribution windows or revenue, pause it, or exclude it from bidding so it still counts in All Conversions but no longer drives automat…

Update a Microsoft Ads conversion goal: rename it, change its attribution windows or revenue, pause it, or exclude it from bidding so it still counts in All Conversions but no longer drives automated bidding. The goal’s existing type must be supplied, which microsoft_ads_list_conversion_goals returns.

App	Microsoft Ads
Operation ID	microsoft_ads_update_conversion_goal
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	DynamicAccount	Yes	-	Microsoft Ads account that owns the conversion goal.
goal_id	string or integer	Yes	-	ID of the goal to update. microsoft_ads_list_conversion_goals returns these.
goal_type	enum (Url, Duration, PagesViewedPerVisit, Event, AppInstall, AppDownload, OfflineConversion, InStoreTransaction)	Yes	-	The goal’s existing type, which Microsoft requires on every update so it knows which shape to apply. Read it from microsoft_ads_list_conversion_goals rather than guessing; the type itself cannot be changed.
name	string	No	-	New goal name, unique across the customer’s goals.
status	enum (Active, Paused)	No	-	Set Paused to retire the goal. Microsoft has no delete for conversion goals, so this is the only way to stop one recording.
exclude_from_bidding	boolean	No	-	True keeps the goal out of the Conversions, Conversion Rate, Cost Per Conversion and Revenue columns and out of automated bidding, while All Conversions keeps counting it. Same as unchecking Include in Conversions in the web interface. Only available to accounts in Microsoft’s Include in Conversions pilot, and rejected outright otherwise.
goal_category	string	No	-	New reporting category, for example Purchase, Signup or Other.
count_type	enum (All, Unique)	No	-	All counts every conversion per click, Unique counts one.
conversion_window_in_minutes	integer	No	-	Click conversion window in minutes, up to 129600 which is 90 days.
view_through_conversion_window_in_minutes	integer	No	-	View conversion window in minutes, up to 43200 which is 30 days.
revenue_type	enum (FixedValue, VariableValue, NoValue)	No	-	Setting any revenue field replaces the goal’s whole revenue configuration rather than merging into it, so supply the values you want kept.
revenue_value	number	No	-	Value of one conversion, used when revenue_type is FixedValue.
revenue_currency	string	No	-	Currency code for the revenue value.
url_expression	string	No	-	Url goals: replacement URL text to match, without the protocol.
url_operator	enum (Equals, Contains, BeginsWith, RegularExpression)	No	-	Url goals: how url_expression is matched.
minimum_duration_in_seconds	integer	No	-	Duration goals: seconds on site before the goal counts.
minimum_pages_viewed	integer	No	-	PagesViewedPerVisit goals: pages viewed before the goal counts.
action_expression	string	No	-	Event goals: the UET event action to match.
action_operator	enum (Equals, Contains, BeginsWith)	No	-	Event goals: how action_expression is matched.
category_expression	string	No	-	Event goals: the UET event category to match.
category_operator	enum (Equals, Contains, BeginsWith)	No	-	Event goals: how category_expression is matched.
label_expression	string	No	-	Event goals: the UET event label to match.
label_operator	enum (Equals, Contains, BeginsWith)	No	-	Event goals: how label_expression is matched.

Output

Type: Dict

Returns the goal as it stands after the update.

Fields: id, name, type, status, goal_category, count_type, exclude_from_bidding, tracking_status