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

> Low-level operation to update tiktok ad groups, supports both manual and Upgraded Smart+ ad groups; Markifact resolves the correct endpoint automatically

Low-level operation to update tiktok ad groups, supports both manual and Upgraded Smart+ ad groups; Markifact resolves the correct endpoint automatically. Use focused operations first when available, for example tiktok\_ads\_update\_ad\_group\_budget or tiktok\_ads\_update\_ad\_group\_status. Use tiktok\_ads\_list\_ad\_groups first to inspect the current payload. Use PATCH\_FIELDS for partial updates and REPLACE\_PAYLOAD for full payload updates.

|                       |                              |
| --------------------- | ---------------------------- |
| **App**               | TikTok Ads                   |
| **Operation ID**      | `tiktok_ads_update_ad_group` |
| **Type**              | Action                       |
| **Connection**        | `tiktok_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 TikTok Ads account (advertiser) that owns the ad group.                                                                                                                                                                                                         |
| `ad_group_id`    | string or SelectItem       | Yes      | -              | TikTok ad group ID to update. Markifact uses this value as adgroup\_id and does not require adgroup\_id inside update\_payload.                                                                                                                                            |
| `update_mode`    | string or SelectableOption | No       | `PATCH_FIELDS` | Use PATCH\_FIELDS to update only provided fields. Use REPLACE\_PAYLOAD only when providing the full TikTok update payload.                                                                                                                                                 |
| `update_payload` | object or string           | Yes      | -              | TikTok ad group fields to update as an object or JSON string. Examples: adgroup\_name, location\_ids, bid\_price, targeting\_spec. Use tiktok\_ads\_list\_ad\_groups first when you need the current payload or exact field names. Exclude advertiser\_id and adgroup\_id. |
| `dry_run`        | boolean                    | No       | `False`        | When true, do not call TikTok. Return the resolved endpoint, detected ad group mode, 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. |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `Dict`

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