> ## 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 Ad Group

> Updates Amazon Ads ad groups with a raw Ads API v1 payload; only the provided fields are changed (for example the default bid)

Updates Amazon Ads ad groups with a raw Ads API v1 payload; only the provided fields are changed (for example the default bid). Prefer amazon\_ads\_update\_ad\_group\_status or amazon\_ads\_rename\_ad\_group for plain changes. Supports dry\_run.

|                       |                              |
| --------------------- | ---------------------------- |
| **App**               | Amazon Ads                   |
| **Operation ID**      | `amazon_ads_update_ad_group` |
| **Type**              | Action                       |
| **Connection**        | `amazon_ads` (required)      |
| **Credits per run**   | 1                            |
| **Agent / MCP tool**  | Yes                          |
| **Requires approval** | Yes (write operation)        |

## Inputs

| Field            | Type                 | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------- | -------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`        | DynamicAccount       | Yes      | -       | Select the Amazon Ads profile that owns the ad group.                                                                                                                                                                                                                                                                                                                                                                                              |
| `ad_group_id`    | string or SelectItem | Yes      | -       | Amazon Ads ad group ID to update. Markifact sends it as adGroupId; do not repeat it inside update\_payload.                                                                                                                                                                                                                                                                                                                                        |
| `update_payload` | object or string     | Yes      | -       | Ad group fields to update as a JSON object in raw Amazon Ads API v1 format (camelCase), sent as-is; only the fields you include are changed. Common fields: name, state (ENABLED/PAUSED/DRAFT), bid (defaultBid in plain currency), startDateTime and endDateTime (ISO datetimes), tags. Prefer amazon\_ads\_update\_ad\_group\_status or amazon\_ads\_rename\_ad\_group for plain status or name changes. Example: \{"bid": \{"defaultBid": 2.5}} |
| `dry_run`        | boolean              | No       | `False` | When true, do not call Amazon. Return the resolved endpoint and final payload for review.                                                                                                                                                                                                                                                                                                                                                          |

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

## Output

**Type**: `Dict`

Returns ad\_group\_id, updated\_fields, endpoint, final payload, and dry\_run status.

**Fields**: `ad_group_id`, `updated_fields`, `endpoint`, `payload`, `dry_run`