tiktok_ads_enable_creative_intelligence

Enable TikTok Creative Intelligence

Tiktok

Description

Turn creative intelligence on or off for a TikTok advertiser, or list the advertisers that have it. With it on, Hopkin sweeps the advertiser daily: every ad that spent in the last 90 days has its video mirrored, its frames and audio extracted and its creative profiled (hook, format, pacing…), so creative questions answer in one call. Pass ad_account_id (the advertiser ID) with enabled: true to enroll (starts the first sweep at once; sweep.status says whether it started) or enabled: false to stop the daily sweep (creatives already analyzed are kept). Pass neither to list the enrolled advertisers on this connection under data, with last sweep status and creative counts (analyzed / processing / no_source / failed). Enabling is free; each newly analyzed creative costs 5 credits, charged as it is analyzed. Enrollment belongs to the connection: teammates sharing it see and can change it. Enabling needs the advertiser to be in this connection's grant (see tiktok_ads_list_advertisers).

Idempotent

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiktok_ads_enable_creative_intelligence",
    "arguments": {}
  }
}

Parameters

NameTypeRequiredDescription
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (3)
NameTypeRequiredDescription
ad_account_id string Optional TikTok advertiser ID to turn creative intelligence on or off, e.g. "7000000000000000001". Pass with enabled. Omit both to list the enrolled advertisers.minLength: 1, maxLength: 64, pattern: ^\d+$
enabled boolean Optional true enrolls the advertiser and starts its first sweep; false stops the daily sweep (creatives already analyzed are kept). Pass with ad_account_id.
connection_id string Optional Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.