# Update a TikTok ad group configuration

Update classic TikTok adgroup. Works on your own TikTok Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs advertiser id and configuration.

Update classic TikTok adgroup. Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying. Agentik price: free to preview; $0.05 when the change is applied (confirm: true without validateOnly).

- Tool ID: `tiktok-ads/update-adgroup-configuration`
- Name in the catalog: TikTok: Update adgroup configuration
- Provider: [TikTok Ads](/providers/tiktok-ads.md)
- Capability: [TikTok Ads campaign management](/tools/tiktok-ads/campaign-management.md)
- Price: free preview, $0.05 per applied change
- Workspace access is automatic. Connect a platform using the link and notice returned to your AI assistant; an owner or admin completes platform consent and returns to the conversation; see the [guide](/docs/getmcpads.md).
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0,
  "multipliers": [
    {
      "all": [
        {
          "field": "confirm",
          "equals": true
        },
        {
          "field": "validateOnly",
          "truthy": false
        }
      ],
      "setUsd": 0.05
    }
  ]
}
```

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "advertiserId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Exact TikTok numeric ID as a string, never a rounded JavaScript number."
    },
    "configuration": {
      "type": "object",
      "properties": {
        "actions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "action_category_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 100,
                "description": "Native TikTok action category ids. Check the current entity and applicable objective before supplying it."
              },
              "action_period": {
                "type": "number",
                "description": "Native TikTok action period. Check the current entity and applicable objective before supplying it."
              },
              "action_scene": {
                "type": "string",
                "description": "Native TikTok action scene. Check the current entity and applicable objective before supplying it."
              },
              "video_user_actions": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 100,
                "description": "Native TikTok video user actions. Check the current entity and applicable objective before supplying it."
              }
            },
            "additionalProperties": false
          },
          "maxItems": 100,
          "description": "Native TikTok actions. Check the current entity and applicable objective before supplying it."
        },
        "adgroup_id": {
          "type": "string",
          "description": "Existing ad group ID in this advertiser."
        },
        "adgroup_name": {
          "type": "string",
          "description": "Exact ad group business name."
        },
        "age_groups": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok age groups. Check the current entity and applicable objective before supplying it."
        },
        "audience_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok audience ids. Check the current entity and applicable objective before supplying it."
        },
        "audience_rule": {
          "type": "object",
          "additionalProperties": {},
          "description": "Native TikTok audience rule. Check the current entity and applicable objective before supplying it."
        },
        "audience_type": {
          "type": "string",
          "description": "Native TikTok audience type. Check the current entity and applicable objective before supplying it."
        },
        "auto_targeting_enabled": {
          "type": "boolean",
          "description": "Native TikTok auto targeting enabled. Check the current entity and applicable objective before supplying it."
        },
        "automated_keywords_enabled": {
          "type": "boolean",
          "description": "Native TikTok automated keywords enabled. Check the current entity and applicable objective before supplying it."
        },
        "bid_price": {
          "type": "number",
          "description": "Native TikTok bid price. Check the current entity and applicable objective before supplying it."
        },
        "bid_type": {
          "type": "string",
          "description": "Native TikTok bid type. Check the current entity and applicable objective before supplying it."
        },
        "blocked_pangle_app_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok blocked pangle app ids. Check the current entity and applicable objective before supplying it."
        },
        "brand_safety_type": {
          "type": "string",
          "description": "Native TikTok brand safety type. Check the current entity and applicable objective before supplying it."
        },
        "budget": {
          "type": "number",
          "description": "Amount in the advertiser currency. Do not multiply by 100. Supply currency outside configuration."
        },
        "carrier_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok carrier ids. Check the current entity and applicable objective before supplying it."
        },
        "catalog_authorized_bc_id": {
          "type": "string",
          "description": "Native TikTok catalog authorized bc id. Check the current entity and applicable objective before supplying it."
        },
        "category_exclusion_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok category exclusion ids. Check the current entity and applicable objective before supplying it."
        },
        "comment_disabled": {
          "type": "boolean",
          "description": "Native TikTok comment disabled. Check the current entity and applicable objective before supplying it."
        },
        "contextual_tag_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok contextual tag ids. Check the current entity and applicable objective before supplying it."
        },
        "conversion_bid_price": {
          "type": "number",
          "description": "Native TikTok conversion bid price. Check the current entity and applicable objective before supplying it."
        },
        "dayparting": {
          "type": "string",
          "description": "Exactly 336 binary digits describing half-hour slots across a week, in the advertiser timezone."
        },
        "deep_bid_type": {
          "type": "string",
          "description": "Native TikTok deep bid type. Check the current entity and applicable objective before supplying it."
        },
        "deep_cpa_bid": {
          "type": "number",
          "description": "Native TikTok deep cpa bid. Check the current entity and applicable objective before supplying it."
        },
        "deep_funnel_event_source": {
          "type": "string",
          "description": "Native TikTok deep funnel event source. Check the current entity and applicable objective before supplying it."
        },
        "deep_funnel_event_source_id": {
          "type": "string",
          "description": "Native TikTok deep funnel event source id. Check the current entity and applicable objective before supplying it."
        },
        "deep_funnel_optimization_event": {
          "type": "string",
          "description": "Native TikTok deep funnel optimization event. Check the current entity and applicable objective before supplying it."
        },
        "deep_funnel_optimization_status": {
          "type": "string",
          "description": "Native TikTok deep funnel optimization status. Check the current entity and applicable objective before supplying it."
        },
        "device_model_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok device model ids. Check the current entity and applicable objective before supplying it."
        },
        "device_price_ranges": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "maxItems": 100,
          "description": "Native TikTok device price ranges. Check the current entity and applicable objective before supplying it."
        },
        "exclude_age_under_eighteen": {
          "type": "boolean",
          "description": "Native TikTok exclude age under eighteen. Check the current entity and applicable objective before supplying it."
        },
        "excluded_audience_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok excluded audience ids. Check the current entity and applicable objective before supplying it."
        },
        "excluded_custom_actions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "Native TikTok code. Check the current entity and applicable objective before supplying it."
              },
              "days": {
                "type": "number",
                "description": "Native TikTok days. Check the current entity and applicable objective before supplying it."
              }
            },
            "additionalProperties": false
          },
          "maxItems": 100,
          "description": "Native TikTok excluded custom actions. Check the current entity and applicable objective before supplying it."
        },
        "excluded_pangle_audience_package_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok excluded pangle audience package ids. Check the current entity and applicable objective before supplying it."
        },
        "frequency": {
          "type": "number",
          "description": "Native TikTok frequency. Check the current entity and applicable objective before supplying it."
        },
        "frequency_schedule": {
          "type": "number",
          "description": "Native TikTok frequency schedule. Check the current entity and applicable objective before supplying it."
        },
        "gender": {
          "type": "string",
          "description": "Native TikTok gender. Check the current entity and applicable objective before supplying it."
        },
        "household_income": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok household income. Check the current entity and applicable objective before supplying it."
        },
        "included_custom_actions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "Native TikTok code. Check the current entity and applicable objective before supplying it."
              },
              "days": {
                "type": "number",
                "description": "Native TikTok days. Check the current entity and applicable objective before supplying it."
              }
            },
            "additionalProperties": false
          },
          "maxItems": 100,
          "description": "Native TikTok included custom actions. Check the current entity and applicable objective before supplying it."
        },
        "included_pangle_audience_package_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok included pangle audience package ids. Check the current entity and applicable objective before supplying it."
        },
        "interest_category_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok interest category ids. Check the current entity and applicable objective before supplying it."
        },
        "interest_keyword_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok interest keyword ids. Check the current entity and applicable objective before supplying it."
        },
        "ios14_targeting": {
          "type": "string",
          "description": "Native TikTok ios14 targeting. Check the current entity and applicable objective before supplying it."
        },
        "is_hfss": {
          "type": "boolean",
          "description": "Native TikTok is hfss. Check the current entity and applicable objective before supplying it."
        },
        "is_lhf_compliance": {
          "type": "boolean",
          "description": "Native TikTok is lhf compliance. Check the current entity and applicable objective before supplying it."
        },
        "isp_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok isp ids. Check the current entity and applicable objective before supplying it."
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok languages. Check the current entity and applicable objective before supplying it."
        },
        "location_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Explicit geographic targeting IDs returned by TikTok targeting catalogs; do not invent country IDs."
        },
        "min_android_version": {
          "type": "string",
          "description": "Native TikTok min android version. Check the current entity and applicable objective before supplying it."
        },
        "min_ios_version": {
          "type": "string",
          "description": "Native TikTok min ios version. Check the current entity and applicable objective before supplying it."
        },
        "network_types": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok network types. Check the current entity and applicable objective before supplying it."
        },
        "next_day_retention": {
          "type": "number",
          "description": "Native TikTok next day retention. Check the current entity and applicable objective before supplying it."
        },
        "operating_systems": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok operating systems. Check the current entity and applicable objective before supplying it."
        },
        "pacing": {
          "type": "string",
          "description": "Native TikTok pacing. Check the current entity and applicable objective before supplying it."
        },
        "purchase_intention_keyword_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok purchase intention keyword ids. Check the current entity and applicable objective before supplying it."
        },
        "roas_bid": {
          "type": "number",
          "description": "Native TikTok roas bid. Check the current entity and applicable objective before supplying it."
        },
        "saved_audience_id": {
          "type": "string",
          "description": "Native TikTok saved audience id. Check the current entity and applicable objective before supplying it."
        },
        "schedule_end_time": {
          "type": "string",
          "description": "Delivery end: ISO 8601 with offset or native UTC; must follow start."
        },
        "schedule_start_time": {
          "type": "string",
          "description": "Delivery start: ISO 8601 with offset, or native YYYY-MM-DD HH:MM:SS explicitly in UTC. Converted to UTC for TikTok."
        },
        "schedule_type": {
          "type": "string",
          "description": "SCHEDULE_START_END requires both dates. SCHEDULE_FROM_NOW requires a start."
        },
        "search_keywords": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "keyword": {
                "type": "string",
                "description": "Native TikTok keyword. Check the current entity and applicable objective before supplying it."
              },
              "keyword_bid": {
                "type": "number",
                "description": "Keyword bid in account currency; requires the actual currency outside configuration, including on nested keyword-only updates."
              },
              "keyword_bid_type": {
                "type": "string",
                "description": "Native TikTok keyword bid type. Check the current entity and applicable objective before supplying it."
              },
              "match_type": {
                "type": "string",
                "enum": [
                  "PHRASE_WORD",
                  "PRECISE_WORD",
                  "BROAD_WORD"
                ],
                "description": "Native TikTok match type. Check the current entity and applicable objective before supplying it."
              }
            },
            "additionalProperties": false
          },
          "maxItems": 100,
          "description": "Native TikTok search keywords. Check the current entity and applicable objective before supplying it."
        },
        "search_result_enabled": {
          "type": "boolean",
          "description": "Native TikTok search result enabled. Check the current entity and applicable objective before supplying it."
        },
        "secondary_optimization_event": {
          "type": "string",
          "description": "Native TikTok secondary optimization event. Check the current entity and applicable objective before supplying it."
        },
        "share_disabled": {
          "type": "boolean",
          "description": "Native TikTok share disabled. Check the current entity and applicable objective before supplying it."
        },
        "shopping_ads_retargeting_actions_days": {
          "type": "number",
          "description": "Native TikTok shopping ads retargeting actions days. Check the current entity and applicable objective before supplying it."
        },
        "shopping_ads_retargeting_custom_audience_relation": {
          "type": "string",
          "description": "Native TikTok shopping ads retargeting custom audience relation. Check the current entity and applicable objective before supplying it."
        },
        "shopping_ads_retargeting_type": {
          "type": "string",
          "description": "Native TikTok shopping ads retargeting type. Check the current entity and applicable objective before supplying it."
        },
        "smart_audience_enabled": {
          "type": "boolean",
          "description": "Native TikTok smart audience enabled. Check the current entity and applicable objective before supplying it."
        },
        "smart_interest_behavior_enabled": {
          "type": "boolean",
          "description": "Native TikTok smart interest behavior enabled. Check the current entity and applicable objective before supplying it."
        },
        "spending_power": {
          "type": "string",
          "description": "Native TikTok spending power. Check the current entity and applicable objective before supplying it."
        },
        "targeting_expansion": {
          "type": "object",
          "properties": {
            "expansion_enabled": {
              "type": "boolean",
              "description": "Native TikTok expansion enabled. Check the current entity and applicable objective before supplying it."
            },
            "expansion_types": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 100,
              "description": "Native TikTok expansion types. Check the current entity and applicable objective before supplying it."
            }
          },
          "additionalProperties": false,
          "description": "Native TikTok targeting expansion. Check the current entity and applicable objective before supplying it."
        },
        "vertical_sensitivity_id": {
          "type": "string",
          "description": "Native TikTok vertical sensitivity id. Check the current entity and applicable objective before supplying it."
        },
        "zipcode_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100,
          "description": "Native TikTok zipcode ids. Check the current entity and applicable objective before supplying it."
        }
      },
      "required": [
        "adgroup_id"
      ],
      "additionalProperties": false,
      "description": "Native TikTok settings. Use tiktok_get_write_context before edits. Advertiser and status fields are controlled separately. Read the schema rather than guessing parameters."
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Actual advertiser currency, required when configuration contains monetary amounts. Verified before any write."
    },
    "confirm": {
      "type": "boolean",
      "description": "Apply only when true. Default is a local preview without any TikTok call. Never retry an uncertain POST automatically."
    },
    "workspace_id": {
      "type": "string",
      "description": "Authorized workspace ID from list_accounts/list_workspaces. Use the user's chosen workspace; never guess between clients. Optional when a unique account identifies it."
    },
    "reason": {
      "type": "string",
      "maxLength": 500,
      "description": "Why, in the person's words or from the evidence (e.g. CPA twice the target for 7 days). Saved with the change in the shared client journal."
    }
  },
  "required": [
    "advertiserId",
    "configuration"
  ]
}
```

## Published example

No example input is published for this tool. Ask for the inputs required by its schema.

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[REST inspection](https://api.agentik.cc/v1/tools/tiktok-ads/update-adgroup-configuration) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tiktok-ads/update-adgroup-configuration) · [Agent index](/llms.txt)