TikTok Ads
Use TikTok API for Business actions to read advertisers, campaigns, ad groups, ads, audiences, creatives, catalogs, Business Centers, balances, billing, and transactions; manage advertiser settings, Asset Groups, disabled-by-default Smart+ and GMV Max resources, catalog feeds and videos, creative sharing, Pangle block lists, and selected compliance workflows; and retrieve MMM, GMV Max, and Smart+ reports.
Verdict
Common use cases
- Check which ads are flagged for review
- Link TikTok creator accounts to campaigns
- Export attribution data for marketing mix models
- Verify creative file names before upload
- Track Smart+ campaign copy tasks
Integration
- Vendor
- TikTok Ads
- Category
- other
- Auth
- OAUTH2
- Tools
- 50
- Composio slug
tiktok_ads
Tools
- Appeal Smart+ Ad
Submit an appeal for a Smart+ ad review decision. Once submitted, the appeal cannot be withdrawn through this tool.
- Assign TikTok Account To Advertiser
Link a TikTok account to an ad account in the same Business Center.
- Check Advertiser Term Status
Check whether a TikTok advertiser has signed a specified agreement.
- Check Change Log Download Task
Check whether an advertiser change-log download task is processing, successful, or failed.
- Check File Names
Check whether one or more image or video file names are already used in an advertiser account.
- Check GMV Max Occupied Custom Shop Ads
Check which Shopping Ads occupy one TikTok Shop identity or product asset.
- Check MMM Data Request
Check one MMM export job. Poll conservatively because TikTok documents up to 24 hours of processing but no polling-rate contract.
- Check Smart+ Campaign Copy Task
Get the results of an asynchronous Upgraded Smart+ campaign copy task.
- Check TikTok Shop GMV Max Availability
Check a TikTok Shop's availability for Product GMV Max campaigns.
- Check UnionPay Verification Requirement
Check whether a business license requires UnionPay verification before submitting advertiser verification details.
- Create Business Center Asset Group
Create an Asset Group in a TikTok Business Center, add advertiser assets and members, and optionally assign each member an advertiser access role.
- Create Business Center Organization Account
Create an Organization Account in an authorized Business Center.
- Create Business Spark Ad
Create a campaign, ad group, and Spark Ad in one request. TikTok's endpoint contract does not document their initial delivery status; the created resources may become eligible for delivery and spend, so verify their status after creation.
- Create Catalog Product Diagnostic Task
Create an asynchronous download task for catalog product diagnostic information.
- Create Catalog Product Set by File
Create an E-commerce catalog product set from an uploaded CSV file.
- Create Change Log Download Task
Create an asynchronous download task for an advertiser's change log.
- Create Creative Pre-Review Task
Create a task to pre-review creative materials for one location.
- Create Creative Welcome Message
Create a welcome message within a TikTok advertiser account.
- Create GMV Max Campaign
Create a GMV Max campaign from TikTok's official campaign model. Mutation QA must use owned test resources and remain disabled or draft; this action does not add an enabling or publishing status.
- Create GMV Max Session
Create a max delivery session for a product or a creative boost session for a video.
- Create MMM Data Request
Create an irreversible Media Mix Modeling export job after explicit confirmation. Processing can take up to 24 hours, and the request cannot be cancelled through this tool once submitted.
- Create Smart+ Ad
Create a Smart+ ad disabled for review in an existing Smart+ ad group. Use the separate Smart+ ad status tool to enable it.
- Create Smart+ Ad Group
Create a Smart+ ad group disabled for review in an existing Smart+ campaign. Use the separate Smart+ ad group status tool to enable it.
- Create Smart+ Campaign
Create a Smart+ campaign disabled for review. Use the separate Smart+ campaign status tool to enable it after review.
- Create Smart+ Campaign Copy Task
Create and start an asynchronous copy task for an Upgraded Smart+ campaign. The copied campaign defaults to DISABLE, but copied ad groups and copied ads default to ENABLE. To keep all copied resources ineligible for delivery and spend, expl
- Create Video Fix Tasks
Create up to 10 Smart Fix tasks for advertiser-owned videos.
- Delete Business Center Asset Groupdestructive
Delete one Asset Group from a TikTok Business Center. This destructive operation revokes members' access to the grouped assets, but does not delete the underlying members or assets.
- Delete Catalog Videodestructive
Permanently delete one uploaded video from an E-commerce catalog. This does not remove copies already synchronized to advertiser creative libraries.
- Delete Creative Assetsdestructive
Delete video or image assets owned by a TikTok advertiser account.
- Delete Customized Identitydestructive
Permanently delete a customized user identity from an advertiser account.
- Delete Customized TikTok Postsdestructive
Permanently delete shop-level customized TikTok posts.
- Delete GMV Max Sessiondestructive
Permanently delete a GMV Max session from an advertiser account.
- Delete Search Ad Negative Keywordsdestructive
Delete negative keywords from one Search Ads campaign or ad group in an authorized advertiser account.
- Delete Smart+ Ad Groupsdestructive
Permanently delete up to 20 Smart+ ad groups.
- Delete Smart+ Adsdestructive
Permanently delete up to 20 Smart+ ads.
- Delete Smart+ Campaignsdestructive
Permanently delete up to 20 Smart+ campaigns.
- Delete Smart+ Resourcesdestructive
Permanently delete up to 20 Smart+ campaigns, ad groups, or ads.
- Disable Business Center Advertiser
Irreversibly disable one ad account in a TikTok Business Center. TikTok may reject accounts that are delivering ads, suspended, unpaid, mid-transfer, or have unbilled autopay charges.
- Get Ad Benchmarks
Get one page of ad benchmark dimensions and dynamic numeric metrics, scoped by exactly one ad_ids, adgroup_ids, or campaign_ids filter.
- Get Advertiser Accounts
Return profile, status, timezone, currency, and other default details for specified authorized TikTok advertiser accounts.
- Get Asset Binding Quota
Get advertiser binding quota usage for a TikTok identity asset.
- Get Bid Protection Details
Get bid protection history for campaigns or ad groups over a date range.
- Get Bid Protection Statuses
Get bid protection statuses for up to 200 campaigns or ad groups.
- Get Business Center Advertiser Attributes
Get currencies and registration regions available when creating ad accounts in a Business Center.
- Get Business Center Asset Group
Get the assets or members of an Asset Group in a Business Center.
- Get Business Center Balance
Read the balance of a TikTok Business Center or Payment Portfolio. This action only retrieves financial information and never funds an account.
- Get Campaign Quota Information
Get SKAN Dedicated Campaign quota information by ad network.
- Get Catalog Category Insights
Get up to 50 top trending product categories and availability metrics for an eligible E-commerce catalog, optionally filtered by category IDs.
- Get Catalog Insight Filters
Get one page of provider-approved category, brand, or availability filter values for product insight endpoints. TikTok returns no pagination metadata, so choose page and page_size explicitly when requesting additional pages.
- Get Change Log Download Task Result
Read the status and change-log content returned for an advertiser's change-log task.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add MCP' and select TikTok Ads from the list. 3. You'll be redirected to TikTok's OAuth consent screen—log in with an account that has advertiser or admin access in your Business Center. 4. Grant the requested scopes, which typically include campaign read/write, creative management, and reporting access. 5. After authorization, Switchy will confirm the connection and display which advertiser accounts are now accessible. 6. To test, create a new Project in Switchy and type '@TikTok Ads check file names for [your-image.jpg]' in the chat—if the MCP responds with usage details or confirmation, the connection is live. 7. For tasks like MMM exports or campaign copies, the MCP will return a task ID you can poll later with a follow-up prompt.
What teammates see: by default, memories from TikTok Ads are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Review Flagged Ads
@TikTok Ads show me all ads in advertiser account [ACCOUNT_ID] that are currently under review or have been rejected in the last 7 days
Check Creative Usage
@TikTok Ads check if the file names [hero-video-v2.mp4, banner-1080x1920.jpg] are already used in advertiser account [ACCOUNT_ID]
Link Creator Account
@TikTok Ads assign the TikTok account @[HANDLE] to advertiser account [ACCOUNT_ID] in our Business Center
Export MMM Data
@TikTok Ads start an MMM data export for advertiser account [ACCOUNT_ID] covering the last 90 days, then give me the task ID to check later
Monitor Campaign Copy
@TikTok Ads check the status of Smart+ campaign copy task [TASK_ID] and let me know if it succeeded or failed
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@TikTok Ads show me all active campaigns for advertiser ID 7234567890123456 and their daily spend so far this month
Found 4 active campaigns for advertiser 7234567890123456. Campaign 'Holiday Collection Launch' (ID: 1789012345678901234) has spent $3,247.82 across 12 days. 'Retargeting - Cart Abandoners' spent $1,890.45 over 8 days. 'Lookalike Expansion Test' spent $567.23 in 3 days. 'Brand Awareness - Gen Z' spent $4,102.67 across 14 days. Total month-to-date spend: $9,808.17 across all campaigns. Note: Spend figures reflect data synced as of 6 hours ago; real-time totals may differ slightly.
This example uses read-only reporting tools that require advertiser-level OAuth scope. TikTok Ads API caches spend data with multi-hour lag, so treat figures as directional rather than real-time. Useful for daily standup reviews but not for live budget pacing decisions.
@TikTok Ads assign TikTok account @fashionbrand_official to advertiser ID 7234567890123456 so we can run Spark Ads with that creator's content
Successfully linked TikTok account @fashionbrand_official (account ID: 6987654321098765432) to advertiser 7234567890123456. This account can now be used as an identity for Spark Ads, allowing you to promote existing organic posts as paid ads while preserving engagement metrics. The account owner must have previously authorized this connection in TikTok's Business Center. You can now reference this identity when creating ad groups with the Spark Ads placement.
This write action requires both advertiser management permissions and prior consent from the TikTok account owner in Business Center. The assignment is immediate but the account won't appear in ad creation flows for 10-15 minutes due to cache propagation. Unlinking later requires manual action in the TikTok Ads Manager UI.
@TikTok Ads review the last 30 days of change logs for advertiser 7234567890123456 and summarize any budget changes that happened outside business hours
Requesting change log export for advertiser 7234567890123456 covering December 1-30. TikTok's API queued the export task (task ID: export_1234567890). Polling shows the file is still processing—TikTok documents up to 24 hours for large accounts. Once ready, I'll parse the CSV for budget modifications timestamped between 6 PM and 8 AM local time. Preliminary note: Change logs capture user actions but not automated system adjustments like Smart+ budget reallocations, so the summary will reflect manual edits only.
This synthesis example chains an async export request with AI reasoning over the resulting CSV. The 24-hour processing window makes this unsuitable for urgent audits. The change log tool requires advertiser read permissions and returns raw event data—AI interprets 'outside business hours' based on account timezone metadata.
Use-case deep-dives
When you need bulk ad-account hygiene across multiple brands
A 6-person agency runs TikTok campaigns for a dozen Shopify stores. Every Monday they audit file names, check appeal statuses, and verify TikTok account assignments across all ad accounts. The TikTok Ads MCP is the right call here because it surfaces 50 tools that let you script these checks in one Switchy chat instead of logging into 12 separate Business Centers. The OAuth2 flow means each team member authenticates once and the workspace shares access. The threshold: if your agency only manages 2-3 clients, the setup overhead probably isn't worth it—just use the TikTok Ads Manager UI. But at 8+ clients, the time saved on repetitive account checks pays back the integration cost in the first week.
When you coordinate Smart+ campaigns for weekly SKU releases
A 3-person DTC brand launches a new product variant every Thursday and needs to copy last week's Smart+ campaign structure, swap the creative, and check GMV Max shop-ad conflicts before the 9am launch. The TikTok Ads MCP handles the asynchronous campaign-copy task and the shop-ad occupancy check in a single Switchy thread, so the team doesn't context-switch between Slack, the ads dashboard, and a spreadsheet. The trade-off: TikTok documents up to 24 hours for some export jobs, so if your launch cadence is same-day turnaround, you'll hit polling delays. For weekly or bi-weekly drops with a 48-hour prep window, this MCP turns a 90-minute manual workflow into a 10-minute chat.
When you need change-log forensics after a budget spike
A solo performance marketer wakes up to a $4k overspend alert and needs to trace which campaign settings changed overnight. The TikTok Ads MCP lets you kick off a change-log download task, poll the status, and pull the file into Switchy's chat context without opening the ads platform. The 50-tool catalog includes appeal submission and term-status checks, so you can also verify whether a policy rejection triggered the pause-and-resume cycle that caused the spike. The limit: if you only audit spend once a quarter, the MCP is overkill—just export the change log manually. But if you're triaging alerts weekly or running attribution experiments that require historical change data, this integration turns a 2-hour investigation into a 15-minute thread.
Frequently asked
What does the TikTok Ads MCP let me do in Switchy?
It gives AI agents direct access to TikTok's advertising platform through 50 tools covering campaign management, creative uploads, audience targeting, and reporting. Your team can ask an agent to check ad performance, appeal review decisions, or link TikTok accounts to ad accounts without opening the TikTok Ads Manager. It's built for teams running paid social campaigns who want to automate repetitive tasks like checking change logs or validating file names before upload.
Do I need admin access to connect TikTok Ads via OAuth?
You need advertiser-level permissions in TikTok Ads Manager to authorize the OAuth connection. The specific scopes depend on which tools your team uses—appealing ad decisions or copying Smart+ campaigns requires write access, while checking MMM data or file names only needs read. TikTok's OAuth flow will show exactly what permissions Switchy requests before you approve. If you only manage one ad account, standard advertiser access is enough.
Can the TikTok Ads MCP create new campaigns from scratch?
No. The available tools focus on managing existing campaigns—copying Smart+ campaigns, appealing review decisions, checking change logs, and linking accounts. To create a new campaign, you still use TikTok Ads Manager directly or their Campaign Creation API separately. This MCP is better suited for teams who already have campaigns running and want agents to handle monitoring, troubleshooting, and incremental changes rather than full campaign setup.
How is this different from just using TikTok Ads Manager?
The MCP lets AI agents perform tasks programmatically without a human logging into the web interface. Instead of manually checking if a file name is taken or polling an MMM export job every hour, you ask an agent in Switchy and it calls the tool directly. It's faster for repetitive checks and batch operations, but TikTok Ads Manager still has the full campaign builder UI and visual creative tools this integration doesn't replicate.
Who on my team should connect the TikTok Ads account?
Whoever owns your TikTok ad account and has advertiser permissions in TikTok Ads Manager. That's usually your paid social lead or growth marketer. Once connected, other Switchy users can invoke the tools through shared agents without needing their own TikTok login. The connection doesn't count against TikTok's user seats, but the API calls do count toward TikTok's rate limits—poll conservatively on tasks like MMM exports.