> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`