What 'Full Tooling' Actually Means
When an AI agent connects to TikTok Ads through a generic MCP wrapper or a raw API client, it gets create, read, update, and delete operations on the TikTok entity hierarchy: campaigns, ad groups, ads, creatives. Four verbs, three entity types. That is enough to run a basic workflow.
It is not enough to run a professional campaign lifecycle.
Professional TikTok campaign management includes:
- Audience estimation before launching a campaign, to validate reach before committing spend
- Ad preview before publishing, to confirm creative renders correctly in each placement before going live
- Bid adjustment workflows that account for bid type compatibility rules per objective
- Entity duplication for scaling winning campaigns to new geographies without rebuilding from scratch
- Targeting search tools that return valid values for location, interest, and behavioral targeting parameters
- Pixel verification before any conversion campaign is created
These are not edge cases. They are routine operations in the weekly workflow of any media buyer running TikTok campaigns at scale. Synter covers all of them across 42 registered TikTok scripts.
The Domain Logic Layer: Rules Encoded Before the API Call
TikTok's Ads API has compatibility rules that are not documented clearly and are not enforced until you submit an invalid request. An agent calling the raw API learns these rules by failing live campaigns. Synter encodes the rules in the scripts themselves, so the agent does not learn them the hard way.
Identity Type Requirements
Every TikTok ad must have an identity type: a TikTok account identity, a custom identity for advertisers without a TikTok account, or an authorized identity for white-label scenarios. The identity type constrains which creative formats and placements are available.
An ad created without a valid identity association fails at the API level with an error that does not clearly explain what "identity type mismatch" means in practice. Synter validates identity type compatibility for the creative format and placement before the call. The error never reaches the platform.
Bid Type Compatibility Rules
TikTok enforces bid type and objective compatibility. Target CPA bidding requires a conversion objective with a working pixel. CPV bidding is only available for video view objectives. oCPM requires minimum historical spend to have an optimization signal. These rules are not consistently documented across TikTok's developer resources.
Synter's scripts encode the compatibility matrix. When the agent attempts to set a bid type, the script validates it against the campaign objective before the API call. Invalid combinations return a specific error with the correction, not a raw API rejection.
Creative Spec Validation by Placement
TikTok creative specifications vary by placement. In-feed video has different requirements than TopView, Branded Hashtag Challenge, or Spark Ads. Resolution, duration, aspect ratio, and file size limits all change by placement. A creative that validates for in-feed will fail for TopView.
Synter validates creative specs against the target placements before upload. If the creative does not meet spec for any of the selected placements, the agent reports the specific mismatch and which placement triggered it. The creative is not uploaded until the validation passes.
Pixel Prerequisites for Conversion Campaigns
A TikTok campaign with a conversion objective without a working pixel has no optimization signal. TikTok's algorithm cannot optimize for conversions it cannot see. The campaign will spend without learning.
Synter checks pixel status before creating any conversion campaign. Pixel must be installed, verified, and have received events in the past 28 days. If it has not, the agent flags the prerequisite before building the campaign structure.
The 5 Planning and Optimization Tools
The 42 TikTok scripts include five tools focused specifically on planning and optimization operations that run before or outside the campaign creation flow:
tiktok_get_audience_estimate
Returns reach range, impression bounds, and CPM estimates for a targeting configuration before creating the ad group. Takes the full targeting spec as input. The right time to discover your audience is too narrow is before the brief, not after launch.
tiktok_adjust_bids
Adjusts bids across one or multiple ad groups with bid type validation. Supports percentage adjustments and absolute values. Validates that the new bid is compatible with the objective and within TikTok's bid range constraints before any write.
tiktok_get_ad_preview
Returns a preview of how an ad will render in each selected placement before the ad is published. Preview generation does not create a live ad. Use it to confirm creative renders correctly across in-feed, TopView, and other placements before committing.
tiktok_duplicate_entity
Creates a copy of an existing campaign, ad group, or ad with specified modifications. Standard workflow for geo expansion: duplicate a winning campaign, adjust targeting to the new market, update budget if needed, and activate. No rebuilding from scratch.
tiktok_search_targeting
Returns valid values for location, interest, and behavioral targeting parameters. TikTok's targeting taxonomy is extensive and not fully explorable through Ads Manager without running search queries. This tool returns the targeting values available for a given query, their IDs (required for API calls), and reach estimates for each value.
Before building ad group targeting, use this tool to find the exact targeting IDs for the interests, behaviors, and locations you want to reach. Targeting built with valid IDs from a search query never fails with "invalid targeting parameter" errors.
The Billing Layer: Every Script Registered With a Credit Cost
Domain logic and planning tools matter. But for a platform serving multiple customers with concurrent agents, they are not the complete story. The billing layer is what makes the tooling safe to run at scale.
| Script Category | Examples | Credit Cost |
|---|---|---|
| Read / reporting | get_campaigns, get_insights, get_ad_preview | 2 credits |
| Write / modification | update_bid, update_status, adjust_bids | 5 credits |
| Creative upload | upload_video, upload_image | 10 credits |
| Audience operations | create_audience, get_estimate | 5–15 credits |
| Campaign creation | create_campaign + ad group + ad | 200 credits |
| Entity duplication | duplicate_entity (per entity) | 25 credits |
Every script in the TikTok toolset is registered with its credit cost and its operation classification (read, write, destructive). Before any execution, the dispatcher checks the credit balance against the operation cost. Insufficient balance returns a specific error before any API call is made to TikTok.
Every script is also in the allowlist. An unregistered script call throws UNKNOWN_TOOL and blocks. No TikTok script runs outside the registered set. The tooling surface is bounded and auditable.
What Full TikTok Tooling Enables in Practice
A media buyer running TikTok campaigns through Synter can complete the following workflow through a single conversational session:
- Search targeting to find audience IDs and validate reach before building
- Audience estimation with the actual targeting config to confirm reach is sufficient
- Creative validation against the target placements before upload
- Pixel prerequisite check before building conversion campaign structure
- Campaign and ad group creation with validated parameters
- Ad preview in each placement before publishing
- Performance review after the first 48 hours
- Bid adjustment based on performance data
- Entity duplication to expand to a second market
None of these steps require leaving the conversation, opening a new tab, or navigating TikTok Ads Manager. The agent has the tools to execute the full workflow. The domain logic is encoded. The prerequisites are checked. The billing is tracked.
Frequently Asked Questions
What does 'full TikTok tooling' mean for an AI agent?
Full tooling means the agent can execute every meaningful operation in the TikTok campaign lifecycle without leaving the conversational interface: campaign creation, ad group targeting, creative upload, audience estimation before launch, bid adjustment, ad preview before publishing, entity duplication for geo expansion, and performance reporting. Not just create and pause.
Why does TikTok require an identity type before ad creation?
TikTok requires advertisers to specify the creative identity associated with an ad: a TikTok account identity, a custom identity, or an authorized identity. The identity type determines which creative formats and placements are available. An ad created without a valid identity association will fail. Synter's scripts validate identity type compatibility before the API call.
What TikTok bid types does Synter support?
Synter supports CPM, CPV, CPC, oCPM (optimized CPM), and target CPA bidding. Not all bid types are compatible with all campaign objectives. TikTok enforces bid type and objective compatibility rules. Synter's scripts encode these compatibility rules and validate before execution, preventing the 'invalid bid type for objective' errors that are common when calling the raw API.
How does TikTok entity duplication work in Synter?
Entity duplication creates a copy of an existing campaign, ad group, or ad with modifications you specify, such as different geographic targets or audience configurations. This is the standard workflow for expanding a winning campaign to new markets without rebuilding it from scratch. Synter's tiktok_duplicate_entity script handles the full duplication including asset references and targeting adjustments.
Does Synter check TikTok pixel prerequisites before creating conversion campaigns?
Yes. Before creating any TikTok campaign using a conversion objective, Synter checks that the pixel is installed, verified, and has received events in the past 28 days. If the pixel is not firing, the agent flags this before building the campaign structure. A conversion campaign without a working pixel will have no optimization signal and will underperform.