TikTok Ads logo

Integrate TikTok Ads with your AI CRM

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.

Explore Triggers and Actions

Appeal Smart+ Ad

Submit an appeal for a Smart+ ad review decision. Once submitted, the appeal cannot be withdrawn through this tool.

ActionTry it

Assign TikTok Account To Advertiser

Link a TikTok account to an ad account in the same Business Center.

ActionTry it

Check Advertiser Term Status

Check whether a TikTok advertiser has signed a specified agreement.

ActionTry it

Check Change Log Download Task

Check whether an advertiser change-log download task is processing, successful, or failed.

ActionTry it

Check File Names

Check whether one or more image or video file names are already used in an advertiser account.

ActionTry it

Check GMV Max Occupied Custom Shop Ads

Check which Shopping Ads occupy one TikTok Shop identity or product asset.

ActionTry it

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.

ActionTry it

Check Smart+ Campaign Copy Task

Get the results of an asynchronous Upgraded Smart+ campaign copy task.

ActionTry it

Check TikTok Shop GMV Max Availability

Check a TikTok Shop's availability for Product GMV Max campaigns.

ActionTry it

Check UnionPay Verification Requirement

Check whether a business license requires UnionPay verification before submitting advertiser verification details.

ActionTry it

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.

ActionTry it

Create Business Center Organization Account

Create an Organization Account in an authorized Business Center.

ActionTry it

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.

ActionTry it

Create Catalog Product Diagnostic Task

Create an asynchronous download task for catalog product diagnostic information.

ActionTry it

Create Catalog Product Set by File

Create an E-commerce catalog product set from an uploaded CSV file.

ActionTry it

Create Change Log Download Task

Create an asynchronous download task for an advertiser's change log.

ActionTry it

Create Creative Pre-Review Task

Create a task to pre-review creative materials for one location.

ActionTry it

Create Creative Welcome Message

Create a welcome message within a TikTok advertiser account.

ActionTry it

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.

ActionTry it

Create GMV Max Session

Create a max delivery session for a product or a creative boost session for a video.

ActionTry it

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.

ActionTry it

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.

ActionTry 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.

ActionTry it

Create Smart+ Campaign

Create a Smart+ campaign disabled for review. Use the separate Smart+ campaign status tool to enable it after review.

ActionTry it

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, explicitly set operation_status to DISABLE on the campaign and on every copied ad group and ad; otherwise provider defaults may enable nested resources.

ActionTry it

Create Video Fix Tasks

Create up to 10 Smart Fix tasks for advertiser-owned videos.

ActionTry it

Delete Business Center Asset Group

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.

ActionTry it

Delete Catalog Video

Permanently delete one uploaded video from an E-commerce catalog. This does not remove copies already synchronized to advertiser creative libraries.

ActionTry it

Delete Creative Assets

Delete video or image assets owned by a TikTok advertiser account.

ActionTry it

Delete Customized Identity

Permanently delete a customized user identity from an advertiser account.

ActionTry it

Delete Customized TikTok Posts

Permanently delete shop-level customized TikTok posts.

ActionTry it

Delete GMV Max Session

Permanently delete a GMV Max session from an advertiser account.

ActionTry it

Delete Search Ad Negative Keywords

Delete negative keywords from one Search Ads campaign or ad group in an authorized advertiser account.

ActionTry it

Delete Smart+ Ad Groups

Permanently delete up to 20 Smart+ ad groups.

ActionTry it

Delete Smart+ Ads

Permanently delete up to 20 Smart+ ads.

ActionTry it

Delete Smart+ Campaigns

Permanently delete up to 20 Smart+ campaigns.

ActionTry it

Delete Smart+ Resources

Permanently delete up to 20 Smart+ campaigns, ad groups, or ads.

ActionTry it

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.

ActionTry it

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.

ActionTry it

Get Advertiser Accounts

Return profile, status, timezone, currency, and other default details for specified authorized TikTok advertiser accounts.

ActionTry it

Get Advertiser Balance

Get one page of ad account balances and budgets for a TikTok Business Center, with optional account filters and detailed balance fields.

ActionTry it

Get Asset Binding Quota

Get advertiser binding quota usage for a TikTok identity asset.

ActionTry it

Get Bid Protection Details

Get bid protection history for campaigns or ad groups over a date range.

ActionTry it

Get Bid Protection Statuses

Get bid protection statuses for up to 200 campaigns or ad groups.

ActionTry it

Get Business Center Activity Log

Get one page of activity-log records for a Business Center.

ActionTry it

Get Business Center Advertiser Attributes

Get currencies and registration regions available when creating ad accounts in a Business Center.

ActionTry it

Get Business Center Asset Group

Get the assets or members of an Asset Group in a Business Center.

ActionTry it

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.

ActionTry it

Get Campaign Quota Information

Get SKAN Dedicated Campaign quota information by ad network.

ActionTry it

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.

ActionTry it

Get Catalog Diagnostics

Get one page of synchronous catalog product diagnostic information.

ActionTry it

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.

ActionTry it

Get Catalog Product Diagnostic Task

Get an asynchronous catalog product diagnostic task result.

ActionTry it

Get Catalog Videos

Get one page of uploaded videos from a catalog.

ActionTry it

Get Change Log Download Task Result

Read the status and change-log content returned for an advertiser's change-log task.

ActionTry it

Get Creative Assets

Return metadata for specified video or image assets in an authorized advertiser's Ads Asset Library.

ActionTry it

Get Creative Fatigue Results

Get one page of Creative Fatigue Detection results for an ad. This API is available only to allowlisted advertisers.

ActionTry it

Get Creative Pre-Review Task

Get the result of a creative pre-review task.

ActionTry it

Get Creative Welcome Messages

Get one page of welcome messages within a TikTok advertiser account.

ActionTry it

Get Custom Audience Details

Get current status and modification history for specified owned or shared custom audiences.

ActionTry it

Get Custom Audience Sharing Log

Get the advertisers with which a specific TikTok custom audience has been shared, including each sharing status.

ActionTry it

Get GMV Max Bid Recommendation

Get TikTok's recommended GMV Max bid for an eligible advertiser and shop.

ActionTry it

Get GMV Max Campaign Info

Get information for one GMV Max campaign owned by an authorized advertiser.

ActionTry it

Get GMV Max Exclusive Authorization

Get an advertiser account's exclusive authorization status for a TikTok Shop.

ActionTry it

Get GMV Max Report

Run one paginated Product or LIVE GMV Max campaign report.

ActionTry it

Get GMV Max Sessions

Get max delivery or creative boost session details by 1 to 20 exact session IDs. This is an ID lookup, not the active-session campaign listing; use LIST_GMV_MAX_CAMPAIGN_SESSIONS to list active sessions for one Product GMV Max campaign.

ActionTry it

Get In-Second Video Performance

Get one page of in-second AD or VIDEO performance. VIDEO mode supports either lifetime data or a bounded start_time/end_time window and returns dynamic metric arrays with ad_id, video_id, and duration info.

ActionTry it

Get MMM Download URL

Obtain a seven-day signed URL for a completed MMM compressed CSV. This action does not follow the URL or download the sensitive report.

ActionTry it

Get MMM Request History

Retrieve MMM request metadata for a UTC+0 date interval. TikTok returns each history item as JSON-formatted text and does not document pagination.

ActionTry it

Get Recommended Search Keywords

Get 20 TikTok search-keyword recommendations for a product, service, or brand query.

ActionTry it

Get Showcase Identity

Get the identity with Showcase permission under an ad account.

ActionTry it

Get Showcase Products

Get one page of products available in a Showcase.

ActionTry it

Get Showcase Regions

Get the regions targetable by a Showcase-bound identity.

ActionTry it

Get Smart+ Ad Groups

List Smart+ ad group details through TikTok's dedicated /smart_plus/adgroup/get/ endpoint. Select this instead of LIST_AD_GROUPS for an exact Smart+ endpoint read; use LIST_AD_GROUPS for regular or mixed-automation inventory.

ActionTry it

Get Smart+ Ads

List Smart+ ad details through TikTok's dedicated /smart_plus/ad/get/ endpoint. Select this instead of LIST_ADS for an exact Smart+ endpoint read; use LIST_ADS for regular or mixed-automation inventory.

ActionTry it

Get Smart+ Campaigns

List Smart+ campaign details through TikTok's dedicated /smart_plus/campaign/get/ endpoint. Select this instead of LIST_CAMPAIGNS for an exact Smart+ endpoint read; use LIST_CAMPAIGNS for regular or mixed-automation inventory.

ActionTry it

Get Smart+ Material Report

Get one page of Smart+ material overview or breakdown reporting.

ActionTry it

Get Smart+ Material Report Breakdown

Get one page of time or material breakdown reporting for Upgraded Smart+.

ActionTry it

Get Smart+ Material Report Overview

Get one page of Upgraded Smart+ material overview reporting.

ActionTry it

Get Smart+ Review Info

Get review information for Smart+ ads or ad materials.

ActionTry it

Get Trending Catalog Products

Get up to 50 trending products from an eligible E-commerce catalog.

ActionTry it

Get Trending Search Keywords

Get the top 20 TikTok search keywords, optionally personalized for a Business Account.

ActionTry it

Get Video Fix Task

Get the results of a Smart Fix task.

ActionTry it

List Ad Accounts Linked to TikTok Account

List one page of ad accounts linked to one TikTok account asset in a Business Center.

ActionTry it

List Ad Groups

List regular or mixed-automation ad group inventory through TikTok's generic /adgroup/get/ endpoint. This reader can filter MANUAL, SMART_PLUS, or UPGRADED_SMART_PLUS campaigns; use LIST_SMART_PLUS_ADGROUPS when the request specifically requires TikTok's dedicated Smart+ ad group endpoint.

ActionTry it

List Ads

List regular or mixed-automation ad inventory through TikTok's generic /ad/get/ endpoint. This reader can filter MANUAL, SMART_PLUS, or UPGRADED_SMART_PLUS campaigns; use LIST_SMART_PLUS_ADS when the request specifically requires TikTok's dedicated Smart+ ad endpoint.

ActionTry it

List Advertiser Budget Changes

Get one page of budget change audit records for an ad account.

ActionTry it

List Advertiser Qualifications

List one page of reusable advertiser qualification records in a Business Center, optionally filtered by verification status.

ActionTry it

List Advertiser Transactions

List one page of advertiser billing transactions accessible through a Business Center, with optional transaction type, fund type, account, and UTC date filters.

ActionTry it

List Business Center Account Costs

Get one page of aggregate Business Center costs and itemized advertiser cost records.

ActionTry it

List Business Center Account Transactions

Get one page of itemized billing transactions for a Business Center, its ad accounts, or a Payment Portfolio, including invoice, tax, billing-type, and account details.

ActionTry it

List Business Center Advertisers

List one page of advertiser-account assets assigned to the authorized user in a specified TikTok Business Center.

ActionTry it

List Business Center Asset Groups

Get one page of Asset Groups in a TikTok Business Center.

ActionTry it

List Business Center Asset Partners

Get one page of Business Center partners associated with an asset.

ActionTry it

List Business Center Billing Groups

Get one page of billing groups in a TikTok Business Center.

ActionTry it

List Business Center Members

Get one page of members in a TikTok Business Center.

ActionTry it

List Business Center Partners

Get one page of partners for a TikTok Business Center.

ActionTry it

List Business Center Pixel Links

Get one page of ad accounts linked to a TikTok Business Center pixel.

ActionTry it

List Business Center Transactions

Get one page of Business Center-level cash or grant fund movements, with aggregate charged and paid amounts. Use account transactions instead for itemized ad-account, Payment Portfolio, invoice, tax, or billing details.

ActionTry it

List Business Centers

List one page of Business Centers accessible to the connected TikTok authorization, optionally restricted to one Business Center ID.

ActionTry it

List Campaign Labels

List one page of campaign labels for an authorized advertiser.

ActionTry it

List Campaigns

List regular or mixed-automation campaign inventory through TikTok's generic /campaign/get/ endpoint. This reader can filter MANUAL, SMART_PLUS, or UPGRADED_SMART_PLUS campaigns; use LIST_SMART_PLUS_CAMPAIGNS when the request specifically requires TikTok's dedicated Smart+ campaign endpoint.

ActionTry it

List Catalogs

List catalogs in a specified TikTok Business Center, optionally restricted to one catalog ID.

ActionTry it

List Creative Portfolios

List one provider page of interactive creative portfolios for an advertiser.

ActionTry it

List Custom Audiences

List one page of owned and shared custom audiences for an authorized advertiser, optionally restricted to specified audience IDs.

ActionTry it

List GMV Max Campaign Sessions

List active max delivery or creative boost sessions for one Product GMV Max campaign ID. This is the campaign-scoped active-session listing; use GET_GMV_MAX_CAMPAIGN_SESSIONS to retrieve specific sessions by session IDs.

ActionTry it

List GMV Max Customized Posts

List one page of shop-level customized TikTok posts for GMV Max.

ActionTry it

List GMV Max Identities

List identities available to an advertiser for GMV Max campaigns.

ActionTry it

List GMV Max Videos

List one page of authorized or custom-post-eligible TikTok posts for a Product GMV Max campaign.

ActionTry it

List Pangle Audience Packages

List the include and exclude audience packages available for an advertiser's Pangle targeting configuration.

ActionTry it

List Search Ad Negative Keywords

List one page of negative keywords for a campaign or ad group in an authorized advertiser account.

ActionTry it

List TikTok Shops for GMV Max

List TikTok Shops available to an advertiser for GMV Max campaigns.

ActionTry it

List Trending Commercial Music

Retrieve up to 100 popular, pre-cleared Commercial Music Library tracks for a TikTok Business Account, region, genre, and popularity window.

ActionTry it

List Trending Videos for Commercial Music

Retrieve the top trending TikTok videos that use a Commercial Music Library track in a selected region.

ActionTry it

Preview Smart+ Ad

Generate a preview link or iframe for a proposed or existing Upgraded Smart+ ad. This is a human-review handoff: have a person inspect the returned rendering before using a separate creation or update tool. This tool never creates or updates an ad.

ActionTry it

Set Search Ad Negative Keywords

Set negative keywords on Search Ads campaigns or ad groups. By default, add the supplied keywords while preserving existing values. With replace=true, replace each object's entire existing negative-keyword set and remove any existing values that are not supplied.

ActionTry it

Set Smart+ Ad Delivery Status

Enable or disable up to 20 Smart+ ads. Enabling ads may start ad delivery and spend.

ActionTry it

Set Smart+ Ad Group Delivery Status

Enable or disable up to 20 Smart+ ad groups. Enabling ad groups may start ad delivery and spend.

ActionTry it

Set Smart+ Campaign Delivery Status

Enable or disable up to 20 Smart+ campaigns. Enabling campaigns may start ad delivery and spend.

ActionTry it

Set Smart+ Delivery Status

Enable or disable up to 20 Smart+ campaigns, ad groups, or ads. Enabling resources may start ad delivery and spend.

ActionTry it

Share Creative Assets

Share controlled creative assets from one advertiser with specified target advertiser accounts.

ActionTry it

Submit UnionPay Verification

Submit identity and UnionPay account details to verify an eligible business license. This starts a sensitive review with no documented rollback.

ActionTry it

Unassign TikTok Account From Advertiser

Unlink a TikTok account from an ad account in the same Business Center. This destructively removes the existing account association.

ActionTry it

Update Advertiser Account

Update one TikTok ad account's name, contact, company, license, certificate, promotion-link, address, or billing tax-number metadata. This action cannot change budgets, funding, payment settings, or account status. Provide at least one metadata field to update.

ActionTry it

Update Advertiser Budgets

Consequential financial action that updates, resets, increments, deducts, or sets minimum budgets for ad accounts in a Business Center. These changes can alter or reset spend controls and may be irreversible; verify the Business Center, ad accounts, operation, and amounts before execution.

ActionTry it

Update Catalog

Update the name of a catalog owned by a TikTok Business Center.

ActionTry it

Update Catalog Feed Schedule Status

Set one catalog feed schedule to ON or OFF. Read the current status first because TikTok rejects an unchanged value; ON starts recurring ingestion.

ActionTry it

Update GMV Max Campaign

Update supported fields on an existing GMV Max campaign; at least one field to update must be provided. Perform mutation QA only on a disabled or draft campaign; this action does not enable or publish it.

ActionTry it

Update GMV Max Campaign Creatives

Remove creatives from a GMV Max campaign or add them back. Include spu_id_list for every item in a Product GMV Max campaign; campaign type is not part of this request.

ActionTry it

Update GMV Max Session

Update documented budget or schedule fields for a max delivery or creative boost session. schedule_start_time applies to max delivery sessions.

ActionTry it

Update Pangle Block List

Update an advertiser's Pangle app block list by adding apps, removing apps, or clearing the existing list before adding replacements. Provide at least one non-empty app list or set clear_old_app to true.

ActionTry it

Update Search Ad Negative Keyword

Update the name or match type of one negative keyword attached to a Search Ads campaign or ad group.

ActionTry it

Update Smart+ Ad

Update an existing Smart+ ad and its material configuration; at least one field to update must be provided.

ActionTry it

Update Smart+ Ad Group

Update an existing Smart+ ad group's name, bid, budget, schedule, pacing, comment or sharing settings, and audience targeting. Omitted settings remain unchanged; at least one field to update must be provided.

ActionTry it

Update Smart+ Ad Group Budgets

Update immediate total budgets or next-day scheduled daily budgets for Upgraded Smart+ ad groups. Provide a non-empty budget or scheduled_budget list. For CBO campaigns where budget_optimize_on is true, a min_budget or max_budget or both must already be configured before a scheduled-budget update; non-CBO ad groups have no such prerequisite.

ActionTry it

Update Smart+ Ad Group Status

Enable, disable, or delete up to 20 Smart+ ad groups.

ActionTry it

Update Smart+ Ad Material Status

Enable or disable up to 20 materials belonging to a Smart+ ad. Enabling materials can make them eligible for delivery and spend.

ActionTry it

Update Smart+ Ad Status

Enable, disable, or delete up to 20 Smart+ ads.

ActionTry it

Update Smart+ Campaign

Update an existing Smart+ campaign's supported fields; at least one field to update must be provided. Perform mutation QA only on a disabled or draft campaign; this action does not enable or publish it.

ActionTry it

Update Smart+ Campaign Status

Explicitly delete, disable, or enable Smart+ campaigns. For safe mutation QA, use DISABLE on owned test campaigns; this action never chooses ENABLE or DELETE by default.

ActionTry it

Upload Business Certificate Image

Upload a business certificate image for an ad account through a Business Center where the connected user is an administrator.

ActionTry it

Upload Catalog Videos by File URL

Upload catalog videos from a file URL.

ActionTry it

How the TikTok Ads integration works

The TikTok Ads integration connects your Dench AI CRM directly to TikTok Ads, so agents can read and act on your TikTok Ads data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.

142 actions are available for agents to invoke on your behalf. Every call runs through TikTok Ads's own authorization, scoped to the account you connect.

Set up TikTok Ads in Dench

  1. 1

    Sign in to your Dench workspace and open Integrations.

  2. 2

    Find TikTok Ads and click Connect — you'll authorize access through TikTok Ads's own sign-in flow. No API keys or code required.

  3. 3

    Ask an agent to use TikTok Ads in chat, or call it from an automation.

  4. 4

    Manage or disconnect the connection any time from workspace settings.

Frequently asked questions

How does the TikTok Ads integration work with Dench?

The Dench TikTok Ads integration connects your AI CRM to TikTok Ads, so AI agents can work with your TikTok Ads data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.

What actions can AI agents perform with TikTok Ads via Dench?

The TikTok Ads integration currently exposes 142 actions, including Appeal Smart+ Ad, Assign TikTok Account To Advertiser, Check Advertiser Term Status, Check Change Log Download Task, Check File Names, and Check GMV Max Occupied Custom Shop Ads. Agents invoke them on your behalf from chat or from automations.

Do I need to write code to connect TikTok Ads to Dench?

No. You connect TikTok Ads from your Dench workspace using TikTok Ads's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.

Is the TikTok Ads integration secure?

Connections are authorized through TikTok Ads's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the TikTok Ads connection from your workspace settings at any time.

TikTok Ads | Dench AI CRM