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

Add a partner to a BC

Add another Business Center as a partner and optionally share advertiser or catalog assets with it.

ActionTry it

Add or delete audience segment mappings

Add or delete user and device mappings for explicitly selected disposable audiences.

ActionTry it

Allocate the credit line to Payment Portfolios

Change the credit-line percentages allocated to up to 10 Payment Portfolios. This directly changes available advertising credit now and whenever the total credit line changes; obtain explicit finance-owner approval immediately before execution and verify every portfolio, used minimum, percentage, and the intended total allocation.

ActionTry it

Appeal a rejection

Submit an appeal for a rejected ad group or an ad within it. This starts an external TikTok review, cannot be withdrawn through this tool, and may require human follow-up; confirm the rejection and supporting evidence before submitting.

ActionTry it

Appeal Smart+ Ad

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

ActionTry it

Apply a Spark Post Authorization Code

Apply a creator-issued authorization code so an advertiser may use that specific TikTok post as a Spark Ad. The creator must generate the code, and duet, stitch, or mentioned-original posts also require the original post's authorization code.

ActionTry it

Apply or Disconnect a Custom Audience

Apply a custom audience to ad groups or disconnect it from them.

ActionTry it

Assign an asset

Assign a Business Center asset and its asset-specific role to a member.

ActionTry it

Assign Members to a Child Business Center

Assign one or more existing members from source child Business Centers to a target child Business Center, optionally setting basic and finance roles.

ActionTry it

Assign TikTok Account To Advertiser

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

ActionTry it

Bind an event source to a catalog

Bind a mobile app, website Pixel, or both to a catalog.

ActionTry it

Bind/Unbind rules

Bind or unbind optimizer rules from existing advertising objects.

ActionTry it

Cancel a subscription

Irreversibly cancel a developer-app webhook subscription.

ActionTry it

Cancel asynchronous report task

Cancel a queued or processing asynchronous TikTok report task. Confirm the advertiser and disposable task ID before calling because cancellation is irreversible.

ActionTry it

Cancel Custom Audience Sharing

Stop sharing a custom audience with an advertiser.

ActionTry it

Cancel the R&F ad order

Cancel the R&F ad order. This operation is destructive or irreversible; confirm exact disposable targets before calling. This operation can affect billing, credit, invoices, budgets, contracts, or payments; require explicit approval and an isolated account.

ActionTry it

Cancel the sharing of assets

Cancel sharing the specified assets with the partner Business Center. The partner loses access to those assets; confirm the exact disposable partner and asset IDs before calling.

ActionTry it

Check a lead download task

Poll an existing TikTok lead download task. Provide the task ID and exactly one owning advertiser or Business Center form-library context; the polling operation does not require the original ad or Instant Form target.

ActionTry it

Check Advertiser Term Status

Check whether a TikTok advertiser has signed a specified agreement.

ActionTry it

Check asynchronous report task

Check, without polling, whether an asynchronous report task is queued, processing, successful, failed, or canceled.

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 the status of a blocked-word export task

Check whether a blocked-word export task is running, succeeded, or failed. Call the download action only after SUCCEED.

ActionTry it

Check the status of a playable asset

Check validation status and failure details for one playable asset.

ActionTry it

Check the statuses of words

Check whether specified words are blocked for an advertiser without changing moderation settings.

ActionTry it

Check the verification status of your account

Check the verification status of an ad account or Business Center.

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

Check Value-Based Optimization eligibility

Check VBO bidding eligibility for a proposed campaign configuration; some options require allowlisting.

ActionTry it

Create a Billing Group

Create a persistent Billing Group and assign ad accounts to it. This changes invoice grouping and may make the group the Business Center default; obtain explicit approval immediately before execution and verify the Business Center, account IDs, immutable group type, email recipients, and is_primary setting.

ActionTry it

Create a blocked-word export task

Create an asynchronous export task for an advertiser's blocked words. Save the returned task ID, poll CHECK_BLOCKEDWORD_TASK until SUCCEED, then download it.

ActionTry it

Create a Business Center

Create a persistent TikTok Business Center organization. This may establish a new administrative and billing boundary with no cleanup operation documented for this tool; obtain explicit approval immediately before execution and verify the name, company, registration area, currency, timezone, type, and contact data.

ActionTry it

Create a campaign

Create a Manual Campaign with documented campaign, objective, budget, RTA, and iOS settings.

ActionTry it

Create a campaign through the shared SPC route

Create a current Smart+ Catalog or Advanced Dedicated Campaign through TikTok's shared SPC route; legacy Smart+ modes are deprecated.

ActionTry it

Create a catalog

Create a catalog in a TikTok Business Center; some catalog types require allowlisting.

ActionTry it

Create a comment export task

Create an asynchronous comment export for a specific advertiser, ad group, and date range. Review the filter because exported comments may contain personal data; poll CHECK_COMMENT_TASK before downloading.

ActionTry it

Create a creative shareable link

Create a link for sharing up to 20 named creative assets. TikTok does not document the link lifetime or revocation behavior.

ActionTry it

Create a CRM Event Set

Create a CRM Event Set configuration in an advertiser account. This does not report or ingest CRM events; an advertiser can have at most 50 CRM Event Sets.

ActionTry it

Create a Custom Conversion

Create a Custom Conversion configuration; this does not ingest conversion events.

ActionTry it

Create a Customer File Audience

Create a custom audience from previously uploaded encrypted customer files.

ActionTry it

Create a feed

Create a scheduled catalog feed. INCREMENTAL preserves products omitted from the next import; OVERWRITE permanently removes omitted products, so confirm the complete source file before using it.

ActionTry it

Create a lead download task

Create an asynchronous export task for leads from one Instant Form or ad. This is a lead export endpoint, not Events API ingestion; only ad-account or Business Center admins can use it.

ActionTry it

Create a Lookalike Audience

Create a lookalike custom audience from an eligible source audience.

ActionTry it

Create a Payment Portfolio

Create a SHARED Payment Portfolio and link ad accounts so they jointly use centrally managed funds. This creates persistent financial configuration; obtain explicit finance-owner approval immediately before execution and verify the name, every account ID, same-client eligibility, and administrator access.

ActionTry it

Create a Pixel

Create a TikTok Pixel configuration; this does not ingest web events.

ActionTry it

Create a portfolio

Create a typed creative portfolio. Availability may depend on TikTok entitlement.

ActionTry it

Create a product set by conditions

Create a catalog product set using one AND or OR condition group.

ActionTry it

Create a Rule-Based Custom Audience

Create a custom audience from conditional inclusion and exclusion event rules.

ActionTry it

Create a Saved Audience

Create a reusable Saved Audience from targeting criteria.

ActionTry it

Create a split test

Create an ad-group or campaign-level split test. Campaign-level tests may require allowlisting.

ActionTry it

Create a subscription

Create a webhook subscription for a developer application and external callback URL.

ActionTry it

Create a test lead

Create a disposable test lead for an Instant Form or direct-message source; remove it after testing.

ActionTry it

Create ads

Create one or more ordinary ads in an existing ad group using documented creative settings. New ads default to DISABLE so they do not start delivery or spend unless operation_status is explicitly set to ENABLE.

ActionTry it

Create an ad account

Create a persistent ad account in a Business Center, optionally configure its invoice grouping, Payment Portfolio linkage, and spending budget. Account creation can succeed even if portfolio binding or budget setup fails. Obtain explicit owner and finance approval immediately before execution; verify identity, region, currency, timezone, qualifications, tax data, payer, portfolio, and budget settings, then inspect both setup-result objects. Some options require TikTok allowlisting.

ActionTry it

Create an ad group

Create an ad group. New ad groups default to DISABLE so they do not start delivery or spend unless operation_status is explicitly set to ENABLE. Availability may depend on TikTok allowlisting or account entitlement.

ActionTry it

Create an app

Create a mobile app for an advertiser.

ActionTry it

Create an asynchronous copy task for a Manual Campaign

Create an asynchronous Manual Campaign copy task. Copied nested resources may default to enabled unless explicitly disabled.

ActionTry it

Create an asynchronous invoice download task

Create a task that generates an invoice list, batch of invoice PDFs, or detailed billing report for later download. This exports finance-sensitive data and creates external task state; obtain explicit approval immediately before execution, verify the Business Center, invoice, output type, date range, payment filters, and campaign, and retrieve the result only to an approved storage destination.

ActionTry it

Create an Identity

Create a customized advertiser identity. This does not authorize a TikTok creator account or a creator post; use the relevant TikTok account or Spark post authorization flow for those identities.

ActionTry it

Create an Offline Event Set

Create an Offline Event Set configuration; this does not upload or ingest offline events.

ActionTry it

Create an R&F ad group

Create an R&F ad group. Availability may depend on TikTok allowlisting or account entitlement.

ActionTry it

Create asynchronous report task

Create an asynchronous TikTok report task and return its task ID; use the separate check and download tools to observe completion and retrieve output.

ActionTry it

Create blocked words

Add exact words to an advertiser's moderation block list. Review the words and advertiser ID before calling because future matching comments may be affected.

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 and start a max delivery session for a product or a creative boost session for a video. Starting the session can begin delivery and spend.

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 or Delete an Audience Segment

Create a named audience segment or delete one by audience ID.

ActionTry it

Create Pixel Events

Create standard Pixel Event configurations and rules; this endpoint does not ingest event occurrences.

ActionTry it

Create rules

Create automated optimizer rules.

ActionTry it

Create shop-level customized TikTok posts

Create shop-level customized TikTok posts.

ActionTry it

Create Smart Creative Ads

Create current Smart Creative ads in an ad group configured with creative_material_mode=SMART_CREATIVE. TikTok returns a mock processing result without ad IDs; wait 2-3 seconds and call GET_SMART_CREATIVE_MATERIALS to read final data. This is not the retired DYNAMIC ACO mode.

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 a catalog

Permanently delete a catalog from a Business Center.

ActionTry it

Delete a comment

Permanently delete one TikTok comment. Before calling, confirm the exact advertiser, ad, video, identity, and disposable comment IDs; deletion cannot be undone.

ActionTry it

Delete a Custom Conversion

Delete a Custom Conversion configuration; this does not delete ingested events.

ActionTry it

Delete a feed

Permanently delete a catalog feed.

ActionTry it

Delete a member or revoke an invitation

Remove an existing member from the Business Center or revoke a pending invitation. This revokes access or invalidates the invitation; confirm the exact disposable user ID or email before calling.

ActionTry it

Delete a partner from a BC

Remove the partner relationship from the Business Center. This revokes the partner relationship and associated access; confirm both exact disposable Business Center IDs before calling.

ActionTry it

Delete a Pixel Event

Delete a Pixel Event configuration; this does not delete ingested event occurrences.

ActionTry it

Delete a playable asset

Permanently delete one exact playable asset. Confirm the advertiser and a disposable playable ID before calling.

ActionTry it

Delete a test lead

Permanently delete one exact disposable TikTok test lead. Confirm the owner and lead ID before calling.

ActionTry it

Delete an Offline Event Set

Delete an Offline Event Set configuration; this is not an event-ingestion operation.

ActionTry it

Delete assets from a BC

Remove the specified asset from the Business Center. This revokes the Business Center relationship and can move a lead asset back to its prior ad account. Confirm the exact Business Center, asset type, and disposable asset ID before calling.

ActionTry it

Delete blocked words

Destructively remove exact words from an advertiser's moderation block list. Confirm the advertiser and disposable targets before calling; comments containing removed words may no longer be flagged.

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 creative portfolios

Permanently delete up to 100 eligible creative portfolios. Use only explicitly confirmed disposable targets; one invalid ID fails the batch.

ActionTry it

Delete Custom Audiences

Delete between one and 100 custom audiences.

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 product sets

Permanently delete one to ten catalog product sets.

ActionTry it

Delete Saved Audiences

Delete up to 100 Saved Audiences.

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+ 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

Discover new keywords

Discover search keyword ideas and historical search metrics.

ActionTry it

Download an invoice synchronously

Download one Business Center invoice. The file contains finance-sensitive billing data; confirm the Business Center and invoice IDs, obtain authorization to access the invoice, and store or share the returned file only in an approved location.

ActionTry it

Download exported blocked words

Download the result of a succeeded blocked-word export task. Confirm the advertiser and task IDs and store the moderation data only in an approved location.

ActionTry it

Download exported comments

Download CSV content from a succeeded comment export task. The file can contain public user content and identifiers; confirm the advertiser and task, then store or share it only in an approved location.

ActionTry it

Download leads from a completed export task

Download the CSV or ZIP produced by a completed TikTok lead export task. The file contains customer lead data, expires about 10 minutes after generation, and must be stored or shared only in an approved location.

ActionTry it

Download negative keywords

Download negative keywords for a campaign or ad group as a spreadsheet file.

ActionTry it

Edit an image

Resize or Gaussian-pad an advertiser image.

ActionTry it

End a split test

End an in-progress split test. This transition is irreversible.

ActionTry it

Estimate audience size

Estimate audience size for documented placement, promotion, and targeting settings. Availability may depend on account entitlement.

ActionTry it

Generate Smart Text recommendations

Generate Smart Text recommendations for an ad group.

ActionTry it

Get a portfolio by ID

Get a creative portfolio by ID. Availability may depend on TikTok entitlement.

ActionTry it

Get a suggested bid

Get a suggested bid for an objective and target locations.

ActionTry it

Get a test lead

Get the current test lead for an Instant Form or direct-message lead source.

ActionTry it

Get a TikTok in-app link

Convert an open TikTok URL to an internal TikTok link; availability may require allowlisting.

ActionTry it

Get action categories

Get targeting action categories available to an advertiser.

ActionTry it

Get ad accounts linked to a Payment Portfolio

Return one page of ad accounts linked to a Payment Portfolio. This is read-only but reveals finance-sensitive payment relationships; confirm the portfolio ID and disclose the result only to authorized finance administrators.

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 additional interest categories by ID

Get up to 50 additional interest categories by ID and language.

ActionTry it

Get Advertiser Accounts

Discover every advertiser account authorized for this connection when no IDs are supplied, or return full profile, status, timezone, and currency details for specified authorized advertiser IDs. Discovery first uses advertiser IDs stored with the OAuth token and only falls back to securely injected app credentials.

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 an asynchronous invoice download task

Get one asynchronous invoice download task and return its documented status and download URL. Use DOWNLOAD_BC_INVOICE for the synchronous invoice file.

ActionTry it

Get an Instant Form or Direct-Message Lead

Retrieve lead answers and attribution metadata. The response can contain names, contact details, and other personal data supplied through form or direct-message questions; call only for an authorized advertiser or Business Center library, minimize retention, and do not disclose or reuse it outside the consented lead-processing purpose.

ActionTry it

Get App Conversion Events

Get app conversion events available for advertising optimization.

ActionTry it

Get App Retargeting Events

Get app retargeting events available for audience rules.

ActionTry it

Get Asset Binding Quota

Get advertiser binding quota usage for a TikTok identity asset.

ActionTry it

Get assets as admin

Get one page of assets administered by a Business Center.

ActionTry it

Get asynchronous invoice download task list

Return one page of asynchronous invoice download tasks and their download URLs. These references expose finance-sensitive billing files; confirm the Business Center and share or download them only to approved destinations.

ActionTry it

Get asynchronous report download

Retrieve output for a successful asynchronous report task. Returns temporary download URL metadata for CSV_DOWNLOAD or XLSX_DOWNLOAD tasks, or inline UTF-8 CSV content for CSV_STRING tasks.

ActionTry it

Get Audience Insights

Get one audience insight dimension for locations or a custom audience.

ActionTry it

Get authorized users for a Payment Portfolio

Return one page of users authorized for a Payment Portfolio. This is read-only but reveals finance access assignments; confirm the portfolio ID and disclose the result only to authorized administrators.

ActionTry it

Get available attribution sources and data sources for an app

Get attribution sources and data sources available for a mobile app.

ActionTry it

Get available content exclusion categories

Get content exclusion and vertical sensitivity categories for an objective.

ActionTry it

Get available contextual tags

Get contextual tags available for an objective and optional regions.

ActionTry it

Get available locations by advertiser ID

Get all locations available to an advertiser, with translated names.

ActionTry it

Get available regions

Get regions where ads for catalogs in a Business Center can be delivered.

ActionTry it

Get available stores under an ad account

Get available TikTok Shops under an ad account.

ActionTry it

Get available verification document types for a region

Get available verification document types for a region.

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 blocked words

Return one page of an advertiser's blocked-word moderation list and an opaque continuation cursor when more results exist.

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 carriers

Get carriers available for ad targeting by country or region.

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 event source diagnostic information

Get detected catalog app or pixel event source issues and suggested solutions.

ActionTry it

Get catalog event trends and match rate

Get daily app or pixel event trends and catalog content-ID match rates.

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 comments

Read one page of comments for a specific advertiser, ad group, and date range. Returns an opaque continuation cursor and does not change moderation state.

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 report

Return one page of creative material performance with exact JSON-encoded filter and field-selection query parameters.

ActionTry it

Get Creative Welcome Messages

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

ActionTry it

Get CRM Event Sets

Get CRM Event Sets for an advertiser, optionally filtered by name or ID.

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 Custom Conversions associated with an event source

Return one page of Custom Conversions configured for a Pixel or app event source.

ActionTry it

Get Details of Audience Overlap

Get overlap details for a benchmark custom audience and up to four comparison audiences.

ActionTry it

Get details of content exclusion categories

Get details for content exclusion or vertical sensitivity category IDs.

ActionTry it

Get details of contextual tags

Get details for specified contextual tag IDs.

ActionTry it

Get Details of Saved Audiences

Return one page of Saved Audience details.

ActionTry it

Get device models

Get device models available for ad targeting.

ActionTry it

Get diagnoses for ad groups

Get issue diagnoses and suggestions for selected ad groups.

ActionTry it

Get estimated info of R&F ad groups

Get estimated info of R&F ad groups.

ActionTry it

Get event source binding info of a catalog

Get apps and pixels bound as event sources to a catalog.

ActionTry it

Get feeds

Get all feeds in a catalog or one feed by ID.

ActionTry it

Get form libraries

Return one page of Business Center form libraries accessible to the connected user.

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 Campaigns

Get one page of GMV Max campaigns.

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 Info About a Spark Ad Post

Resolve a creator-issued Spark post authorization code into post, creator, media, and authorization-window details. Possessing advertiser OAuth does not authorize the creator's post; the creator must issue the code, and expired or restricted posts may not be usable.

ActionTry it

Get Info About an Identity

Get one advertiser identity. BC_AUTH_TT identities require the authorizing Business Center ID; returned capability flags determine whether that creator can retrieve, publish, or manage content.

ActionTry it

Get Info About TikTok Posts

Get one or up to 20 posts associated with an authorized identity. Private/friends-only visibility and expired AUTH_CODE authorization can limit returned media; BC_AUTH_TT requires its authorizing Business Center ID.

ActionTry it

Get info of an app

Get information about a mobile app configured for an advertiser.

ActionTry it

Get Instant Page events

Get supported TikTok Instant Page event options for an optimization goal.

ActionTry it

Get Instant Pages

Return one page of Instant Forms and other TikTok Instant Page types.

ActionTry it

Get interest categories

Get advertiser interest categories, optionally filtered by placement and special industry.

ActionTry it

Get internet service providers

Get ISP targeting tags supported for specified country- or region-level locations.

ActionTry it

Get inventory estimates

Get inventory estimates. Availability may depend on TikTok allowlisting or account entitlement.

ActionTry it

Get languages

Get languages available for ad targeting.

ActionTry it

Get Lead Fields

Retrieve only the field names and form metadata for Instant Form or direct-message leads. Lead schemas can reveal what personal data is collected; use only for an authorized advertiser or Business Center library and do not expose the result beyond the intended lead-processing purpose.

ActionTry it

Get Live Videos Under an Identity

Return one page of live videos for an authorized TikTok account identity. The identity must expose live access; BC_AUTH_TT also requires its authorizing Business Center ID.

ActionTry it

Get locations and currencies

Get supported country or region and currency combinations for catalogs.

ActionTry it

Get Manual Campaign Copy Task Results

Get the results of an asynchronous copy task for a Manual Campaign. Availability may depend on account entitlement.

ActionTry it

Get members by an asset

Get one page of Business Center members assigned to an asset.

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 Music Authorization Info of a Video

Check whether every song in a TikTok post is authorized for a specific identity, targeting-location set, and ad deployment window. This does not grant creator or post authorization; the selected identity and post must already be authorized for advertiser use.

ActionTry it

Get Offline Event Sets

List Offline Event Set configurations; this management endpoint does not ingest offline events.

ActionTry it

Get OS versions

Get operating-system versions available for targeting.

ActionTry it

Get Payment Portfolios

Return one page of Payment Portfolios, cash balances, and credit line usage. This exposes highly sensitive financial capacity and account relationships; confirm the Business Center and filters and disclose results only to authorized finance administrators.

ActionTry it

Get phone region codes

Get region names, region codes, and calling codes for phone numbers.

ActionTry it

Get Pixel Event statistics

Get UTC Pixel Event statistics; this reporting endpoint does not ingest events.

ActionTry it

Get Pixels

Return one page of Pixels and their configured Pixel Events.

ActionTry it

Get playable assets

Return one page of playable assets for an advertiser.

ActionTry it

Get Posts Under an Identity

Return one page of posts visible through an authorized identity. AUTH_CODE exposes only creator-authorized posts; TT_USER and BC_AUTH_TT access depends on the account's can_pull_video capability, privacy status, and Business Center authorization.

ActionTry it

Get product linkage details of videos in customized posts

Get product linkage details of videos in customized posts.

ActionTry it

Get product sets

Get all product sets in a catalog or one product set by ID.

ActionTry it

Get products

Get one page of catalog products with optional IDs, filters, and ordering.

ActionTry it

Get products in a product set

Get one page of products in a catalog product set.

ActionTry it

Get products within a TikTok Shop

Get one page of products within a TikTok Shop.

ActionTry it

Get R&F time zones

Get R&F time zones.

ActionTry it

Get recommended CTAs

Get standard or Dynamic CTA recommendations for an advertiser.

ActionTry it

Get Recommended Search Keywords

Requires a TikTok Business Account token issued by /tt_user/oauth2/token/. The advertiser OAuth connection used by this toolkit cannot call this endpoint.

ActionTry it

Get recommended search keywords

Get one page of recommended search keywords from exactly one seed type.

ActionTry it

Get related comments

Read one page of comments related to a specific TikTok comment and return an opaque continuation cursor. This action does not alter moderation state.

ActionTry it

Get result details

Get automated optimizer rule result details.

ActionTry it

Get review info of ad groups

Get review info of ad groups.

ActionTry it

Get review info of ads

Get review information for one to 100 ads.

ActionTry it

Get rule results

Get one page of automated optimizer rule results.

ActionTry it

Get rules by filters

Get one page of automated optimizer rules by filters.

ActionTry it

Get rules by ID

Get automated optimizer rules by ID.

ActionTry it

Get Search Ads Campaign Health diagnoses

Get Search Ads Campaign Health diagnoses for an ad group or ads.

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 Creative Materials

Get current Smart Creative materials for 1-100 ad groups. The provider returns one complete bounded result and documents no page or cursor wire parameters. This reads SMART_CREATIVE mode, not retired DYNAMIC ACO.

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+ Review Info

Get review information for Smart+ ads or ad materials.

ActionTry it

Get Spark Ad Posts

Return one page of Spark posts bound to an advertiser. Each post remains subject to its creator-issued authorization status and window; advertiser OAuth alone does not grant rights to use a creator's post.

ActionTry it

Get subscription details of a developer app

Return one page of webhook subscriptions configured for a developer application.

ActionTry it

Get suggested thumbnails for a video

Get up to ten suggested thumbnail images for an advertiser video.

ActionTry it

Get targeting hashtags by ID

Get targeting hashtag names and availability by keyword ID.

ActionTry it

Get targeting information

Get geographical or ISP targeting tag details by targeting ID.

ActionTry it

Get targeting regions

Get locations available for an advertiser's placement, objective, and campaign settings.

ActionTry it

Get Terms

Get an advertiser agreement in the requested language.

ActionTry it

Get the advertiser list of a Billing Group

Return one page of ad accounts assigned to a Billing Group. This is read-only but exposes finance-sensitive billing membership; confirm the Business Center and Billing Group before retrieving or sharing the result.

ActionTry it

Get the app list

Get the mobile apps configured for an advertiser.

ActionTry it

Get the Application Log of Audiences

Return one page of audience application history.

ActionTry it

Get the assets of a partner

Get one page of assets shared with or by a partner Business Center.

ActionTry it

Get the authorization status of a Brand Safety partner

Get a Brand Safety measurement partner's authorization status.

ActionTry it

Get the Brand Safety Hub settings of an ad account

Get the Brand Safety Hub settings configured for an advertiser account.

ActionTry it

Get the catalog video handling log

Get processing counts, errors, warnings, and downloads for a catalog video task.

ActionTry it

Get the details of a Custom Conversion

Get one Custom Conversion configured for a Pixel or app event source.

ActionTry it

Get the dynamic quota on active ad groups

Get the dynamic quota on active ad groups.

ActionTry it

Get the fields of an Instant Form

Get the field definitions and metadata for one TikTok Instant Form.

ActionTry it

Get the Identity List

Return one page of advertiser identities. Creator-account capabilities and availability are authorization gates: inspect can_pull_video, can_push_video, ads_only_mode, is_gpppa, and available_status before using an identity for posts or Spark Ads.

ActionTry it

Get the invoices of a Business Center

Return one page of Business Center invoices using documented type, payment, title, ID, and issuance-time filters. This exposes finance-sensitive invoice, tax, address, and balance data; confirm the Business Center and restrict the result to authorized recipients.

ActionTry it

Get the lexicon list for a catalog

Get the provider-defined lexicon list for a catalog.

ActionTry it

Get the log of a feed

Get processing log entries for a catalog feed.

ActionTry it

Get the message event sets for ad creation

Get message event sets available for instant-messaging ad creation.

ActionTry it

Get the music list

Get one page of advertiser music and return a continuation cursor.

ActionTry it

Get the overview of a catalog

Get product audit totals for a catalog.

ActionTry it

Get the Pangle Block List

Get an advertiser's Pangle app block list and its last modification time.

ActionTry it

Get the product handling log

Get processing counts, errors, warnings, and downloads for a product handling task.

ActionTry it

Get the results of a split test

Get the current status and statistical results of a split test.

ActionTry it

Get the status of a comment export task

Check whether a comment export task is running, succeeded, or failed. Call the download action only after SUCCEED.

ActionTry it

Get the TikTok Minis within an ad account

Get one page of TikTok Minis within an ad account.

ActionTry it

Get the unpaid amount of a Business Center

Read the reconciliation-invoice unpaid amount for a Business Center. This exposes finance-sensitive balance data; confirm the Business Center and limit disclosure of the returned amount and currency to authorized recipients.

ActionTry it

Get time zones

Get time zones available to advertisers.

ActionTry it

Get Trending Catalog Products

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

ActionTry it

Get Trending Search Keywords

Requires a TikTok Business Account token issued by /tt_user/oauth2/token/. The advertiser OAuth connection used by this toolkit cannot call this endpoint.

ActionTry it

Get Video Fix Task

Get the results of a Smart Fix task.

ActionTry it

Get video packages

Get catalog video packages, optionally restricted to one package ID.

ActionTry it

Grant an ad account exclusive authorization for a TikTok Shop

Grant an ad account exclusive authorization for a TikTok Shop.

ActionTry it

Invite members to a BC

Invite users to a Business Center and optionally assign advertiser and finance roles.

ActionTry it

Link ad accounts to a Payment Portfolio

Link up to 20 ad accounts to an Advanced Payment Portfolio, changing which centrally managed funds those accounts can use. Obtain explicit finance-owner approval immediately before execution and verify the portfolio, every ad account, same-client eligibility, and administrator access; the whole call fails for one invalid ID.

ActionTry it

Link or unlink a pixel and ad accounts

Ensure the requested link or unlink relationship between a Business Center pixel and advertiser accounts.

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 Available TikTok Series

Return one page of TikTok Series from a specified TikTok account identity that the advertiser can promote. This only lists available Series and does not create or purchase them.

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

Requires a TikTok Business Account token issued by /tt_user/oauth2/token/. The advertiser OAuth connection used by this toolkit cannot call this endpoint.

ActionTry it

List Trending Videos for Commercial Music

Requires a TikTok Business Account token issued by /tt_user/oauth2/token/. The advertiser OAuth connection used by this toolkit cannot call this endpoint.

ActionTry it

Migrate a catalog to a BC

Migrate a catalog from an ad account to a Business Center.

ActionTry it

Migrate leads to a Business Center

Migrate an advertiser's leads into a newly created Business Center form library. Confirm both account IDs before changing lead ownership location.

ActionTry it

Process a payment

Irreversibly recharge or deduct cash, vouchers, or credit for an ad account or Business Center. This moves real financial value and cannot be assumed reversible. Require explicit finance-owner confirmation immediately before execution; verify the level, payer and payee IDs, portfolio, RECHARGE versus REFUND direction, currency context, every amount, minimum transfer limits, and a fresh idempotency request ID. Never retry with a different request ID after an uncertain result. Some behavior is allowlist-only.

ActionTry it

Query contracts

Read whether an advertiser has a valid Reach & Frequency or TikTok Pulse contract for a specified date. This operation does not create, update, or otherwise mutate contracts or financial settings. Availability may depend on TikTok allowlisting or account entitlement.

ActionTry it

Recommend additional interest categories

Recommend additional interest categories from one or more seed keywords.

ActionTry it

Recommend targeting categories

Recommend interest and action targeting categories for specified regions and an optional app.

ActionTry it

Remove products

Remove products from a catalog using the ID list for that catalog type.

ActionTry it

Reply to a comment

Publish a public reply as the specified TikTok identity. Confirm the account, target comment, identity, and final text before calling; the reply is externally visible.

ActionTry it

Run synchronous integrated report

Return one page of a synchronous TikTok report with dimensions, metrics, advertiser lists, and filters encoded as provider JSON query values.

ActionTry it

Run the winning ad group

End a split test by promoting its selected winning ad group and starting that ad group's delivery, which may incur spend.

ActionTry it

Save a playable asset

Save and name a previously uploaded playable asset for an advertiser.

ActionTry it

Search for images

Search for one page of advertiser images and return a continuation cursor.

ActionTry it

Search for targeting hashtags

Generate targeting hashtag recommendations from up to ten seed keywords.

ActionTry it

Search for videos

Search for one page of advertiser videos and return a continuation cursor.

ActionTry it

Search or list interest and behavior targeting

Search for or list targeting categories and hashtags for interests and behaviors.

ActionTry it

Search targeting tags

Search geographical targeting tags by location, ZIP-code, or postal-code keywords.

ActionTry it

Set or update the Brand Safety Hub settings of an ad account

Set or update an advertiser account's Brand Safety Hub settings. Setting cover_all_ad_objectives to true is irreversible and cannot be reverted.

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+ 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

Share Custom Audiences

Share up to ten custom audiences with up to ten advertisers in the same Business Center.

ActionTry it

Sign Terms

Sign the selected advertiser agreement.

ActionTry it

Submit a verification request for your account

Submit sensitive business or individual identity details for external review of an ad account or Business Center; the submission cannot be withdrawn through this tool.

ActionTry it

Submit Smart Text feedback

Submit feedback parameters for an existing Smart Text recommendation flow. This feedback operation does not generate text; use GENERATE_CREATIVE_SMART_TEXT to create recommendations.

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

Transfer a pixel from advertiser to BC

Permanently transfer ownership of the specified advertiser pixel to the destination Business Center. This ownership transfer is irreversible through this tool; confirm the exact pixel and destination Business Center before calling.

ActionTry it

Unassign an asset

Revoke the specified member's access to the Business Center asset. The member immediately loses the assigned permissions; confirm the exact disposable member and asset before calling.

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

Unbind a Spark Ad Post

Irreversibly remove an advertiser's binding to the exact Spark post. Confirm the advertiser and post with the user before calling; using the post again requires a valid creator-issued authorization flow.

ActionTry it

Unbind an event source from a catalog

Unbind a mobile app, website Pixel, or both from a catalog.

ActionTry it

Update a Billing Group

Update Billing Group membership, name, email recipients, or default status. Providing new_billing_group_emails replaces the entire existing list, removing accounts changes invoice grouping, and is_primary changes the default group. Obtain explicit approval immediately before execution and verify every changed value.

ActionTry it

Update a blocked word

Replace one exact blocked word in an advertiser's moderation list. Confirm both old and new values before calling because the moderation behavior changes immediately.

ActionTry it

Update a campaign

Update the mutable fields of an existing campaign.

ActionTry it

Update a Custom Audience

Rename, refresh from files, enhance, or convert a custom audience subtype.

ActionTry it

Update a Custom Conversion

Update the name or description of a Custom Conversion configuration.

ActionTry it

Update a feed

Update a catalog feed or schedule. INCREMENTAL preserves products omitted from the next import; OVERWRITE permanently removes omitted products, so confirm the complete source file before using it.

ActionTry it

Update a Pixel

Update Pixel naming, matching, cookie, or expanded-data-sharing configuration.

ActionTry it

Update a Pixel Event

Update a Pixel Event configuration; this endpoint does not ingest event occurrences.

ActionTry it

Update a product set

Update a product set name, filter conditions, or both.

ActionTry it

Update ads

Update ordinary ads and their documented creative fields.

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 an ad group

Update an ad group. Some changes are irreversible: FROZEN permanently terminates the ad group, and is_hfss can change from false to true but not back to false. Availability may depend on TikTok allowlisting or account entitlement.

ActionTry it

Update an app

Update a mobile app configured for an advertiser.

ActionTry it

Update an Asset Group

Rename an Asset Group or add or remove its advertiser assets or members.

ActionTry it

Update an Offline Event Set

Update an Offline Event Set configuration; this does not upload or ingest events.

ActionTry it

Update an R&F ad group

Update an R&F ad group. Availability may depend on TikTok allowlisting or account entitlement.

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 catalog products

Update up to 5,000 products using the fields documented for each catalog type.

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 info of a BC member

Update a Business Center member's name, basic role, or finance role.

ActionTry it

Update Lookalike Audiences

Update specified lookalike custom audiences.

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 rules

Update automated optimizer rules.

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 Creative Material Status

Enable or disable current Smart Creative materials. Enabling a material can make it eligible for delivery and spend. This does not target retired DYNAMIC ACO.

ActionTry it

Update Smart Creative Materials

Update current Smart Creative materials outside Smart+ campaigns. With patch_update=true, omitted top-level fields remain unchanged, but every provided array replaces the entire prior array; first read and resend all existing array items to avoid data loss. Automatically generated ad names cannot be updated. This does not target retired DYNAMIC ACO.

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 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+ 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 the budgets of ad groups

Update the budgets of ad groups. This operation can affect billing, credit, invoices, budgets, contracts, or payments; require explicit approval and an isolated account.

ActionTry it

Update the name of a video

Update an advertiser video name.

ActionTry it

Update the name of an image

Update an advertiser image name.

ActionTry it

Update the operation statuses of campaigns

Enable, disable, or permanently delete campaigns. Enabling may resume ad delivery and spend; postback_window_mode is accepted only while disabling.

ActionTry it

Update the statuses of ad groups

Enable, disable, or permanently delete up to 20 ad groups. Enabling may resume ad delivery and spend; allow_partial_success can leave only some requested ad groups changed.

ActionTry it

Update the statuses of ads

Enable, disable, or permanently delete regular or ACO ads. Enabling may resume ad delivery and spend.

ActionTry it

Update the statuses of comments

Change the moderation visibility status of exact comments. Confirm the advertiser, every comment ID, and whether the operation hides or restores comments before calling; this affects public content.

ActionTry it

Update the statuses of rules

Turn automated optimizer rules on or off, or permanently delete them.

ActionTry it

Update the time of a split test

Update the start and end time of a split test.

ActionTry it

Upload a file

Upload a temporary image, music, video, or playable file by file or URL.

ActionTry it

Upload a file in chunks

Upload one image, video, or music file through TikTok's start, ordered chunk-transfer, and finish workflow. Chunk signatures are computed internally.

ActionTry it

Upload a piece of music

Upload advertiser music or update a Carousel Ads music list.

ActionTry it

Upload a playable asset

Upload a playable ZIP package or reference a file already in TikTok's file repository. Direct packages must be 5 MB or smaller, contain index.html and config.json at the root, and must not load external network resources.

ActionTry it

Upload a video

Upload an advertiser video by local file, URL, temporary file ID, or existing video ID.

ActionTry it

Upload an Audience File

Upload a CSV or TXT customer file after verifying its supplied MD5 signature.

ActionTry it

Upload an image

Upload an advertiser image by local file, URL, or temporary file ID.

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 products

Upload up to 5,000 products using the fields documented for each catalog type.

ActionTry it

Upload Catalog Videos by File URL

Upload catalog videos from a file URL.

ActionTry it

Upload products via a file URL

Ingest a CSV catalog feed from a directly accessible HTTP or HTTPS URL. INCREMENTAL preserves omitted products; OVERWRITE permanently removes omitted products, so confirm the complete source file before using it.

ActionTry it

Upload verification documents

Upload one or two verification document images.

ActionTry it

Validate a URL

Get TikTok verification results for a 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.

403 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 403 actions, including Add a partner to a BC, Add or delete audience segment mappings, Allocate the credit line to Payment Portfolios, Appeal a rejection, Appeal Smart+ Ad, and Apply a Spark Post Authorization Code. 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.