> ## 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 Responsive Search Ad

> Update existing Microsoft Ads responsive search ads (headlines, descriptions, final URL, paths, status)

Update existing Microsoft Ads responsive search ads (headlines, descriptions, final URL, paths, status). Only provided fields are changed.

|                       |                                             |
| --------------------- | ------------------------------------------- |
| **App**               | Microsoft Ads                               |
| **Operation ID**      | `microsoft_ads_update_responsive_search_ad` |
| **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.                                                                                                                                                                                                  |
| `update_type`     | string or SelectableOption                                                | Yes      | -       | Choose whether to update a single responsive search ad or multiple at once. Options: 'single' or 'bulk'.                                                                                                                                            |
| `ad_group_id`     | string or SelectItem                                                      | No       | -       | The ad group ID that contains the ad. Required for single update.                                                                                                                                                                                   |
| `ad_id`           | string or SelectItem                                                      | No       | -       | The ID of the responsive search ad to update. Required for single update.                                                                                                                                                                           |
| `headlines`       | array of string or object                                                 | No       | -       | New full list of headlines (3-15 items, max 30 chars each; replaces existing). Each item is a string or \{text, pinned\_field: HEADLINE\_1/2/3}. Omit to keep existing.                                                                             |
| `descriptions`    | array of string or object                                                 | No       | -       | New full list of descriptions (2-4 items, max 90 chars each; replaces existing). Each item is a string or \{text, pinned\_field: DESCRIPTION\_1/2}. Omit to keep existing.                                                                          |
| `final_url`       | string                                                                    | No       | -       | New landing page URL (http/https). Omit to keep existing.                                                                                                                                                                                           |
| `path_1`          | string                                                                    | No       | -       | New first display path (max 15 chars). Omit to keep existing.                                                                                                                                                                                       |
| `path_2`          | string                                                                    | No       | -       | New second display path (max 15 chars). Omit to keep existing.                                                                                                                                                                                      |
| `ad_status`       | string or SelectableOption                                                | No       | -       | New ad status. Options: ACTIVE or PAUSED. Omit to keep existing.                                                                                                                                                                                    |
| `structured_data` | array (also accepts a comma-separated string)                             | No       | -       | Structured data for bulk update. Required columns: 'ad\_group\_id', 'ad\_id'. Optional editable columns: 'headlines', 'descriptions', 'final\_url', 'path\_1', 'path\_2', 'ad\_status'. Only provided fields are updated. 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 the updated responsive search ads and which fields changed.

**Fields**: `message`, `updated_count`, `results`