Add a partner to a BC
Add another Business Center as a partner and optionally share advertiser or catalog assets with it.
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.
Add another Business Center as a partner and optionally share advertiser or catalog assets with it.
Add or delete user and device mappings for explicitly selected disposable audiences.
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.
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.
Submit an appeal for a Smart+ ad review decision. Once submitted, the appeal cannot be withdrawn through this tool.
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.
Apply a custom audience to ad groups or disconnect it from them.
Assign a Business Center asset and its asset-specific role to a member.
Assign one or more existing members from source child Business Centers to a target child Business Center, optionally setting basic and finance roles.
Link a TikTok account to an ad account in the same Business Center.
Bind a mobile app, website Pixel, or both to a catalog.
Bind or unbind optimizer rules from existing advertising objects.
Irreversibly cancel a developer-app webhook subscription.
Cancel a queued or processing asynchronous TikTok report task. Confirm the advertiser and disposable task ID before calling because cancellation is irreversible.
Stop sharing a custom audience with an advertiser.
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.
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.
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.
Check whether a TikTok advertiser has signed a specified agreement.
Check, without polling, whether an asynchronous report task is queued, processing, successful, failed, or canceled.
Check whether an advertiser change-log download task is processing, successful, or failed.
Check whether one or more image or video file names are already used in an advertiser account.
Check which Shopping Ads occupy one TikTok Shop identity or product asset.
Check one MMM export job. Poll conservatively because TikTok documents up to 24 hours of processing but no polling-rate contract.
Get the results of an asynchronous Upgraded Smart+ campaign copy task.
Check whether a blocked-word export task is running, succeeded, or failed. Call the download action only after SUCCEED.
Check validation status and failure details for one playable asset.
Check whether specified words are blocked for an advertiser without changing moderation settings.
Check the verification status of an ad account or Business Center.
Check a TikTok Shop's availability for Product GMV Max campaigns.
Check whether a business license requires UnionPay verification before submitting advertiser verification details.
Check VBO bidding eligibility for a proposed campaign configuration; some options require allowlisting.
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.
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.
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.
Create a Manual Campaign with documented campaign, objective, budget, RTA, and iOS settings.
Create a current Smart+ Catalog or Advanced Dedicated Campaign through TikTok's shared SPC route; legacy Smart+ modes are deprecated.
Create a catalog in a TikTok Business Center; some catalog types require allowlisting.
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.
Create a link for sharing up to 20 named creative assets. TikTok does not document the link lifetime or revocation behavior.
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.
Create a Custom Conversion configuration; this does not ingest conversion events.
Create a custom audience from previously uploaded encrypted customer files.
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.
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.
Create a lookalike custom audience from an eligible source audience.
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.
Create a TikTok Pixel configuration; this does not ingest web events.
Create a typed creative portfolio. Availability may depend on TikTok entitlement.
Create a catalog product set using one AND or OR condition group.
Create a custom audience from conditional inclusion and exclusion event rules.
Create a reusable Saved Audience from targeting criteria.
Create an ad-group or campaign-level split test. Campaign-level tests may require allowlisting.
Create a webhook subscription for a developer application and external callback URL.
Create a disposable test lead for an Instant Form or direct-message source; remove it after testing.
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.
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.
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.
Create a mobile app for an advertiser.
Create an asynchronous Manual Campaign copy task. Copied nested resources may default to enabled unless explicitly disabled.
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.
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.
Create an Offline Event Set configuration; this does not upload or ingest offline events.
Create an R&F ad group. Availability may depend on TikTok allowlisting or account entitlement.
Create an asynchronous TikTok report task and return its task ID; use the separate check and download tools to observe completion and retrieve output.
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.
Create an Asset Group in a TikTok Business Center, add advertiser assets and members, and optionally assign each member an advertiser access role.
Create an Organization Account in an authorized Business Center.
Create a campaign, ad group, and Spark Ad in one request. TikTok's endpoint contract does not document their initial delivery status; the created resources may become eligible for delivery and spend, so verify their status after creation.
Create an asynchronous download task for catalog product diagnostic information.
Create an E-commerce catalog product set from an uploaded CSV file.
Create an asynchronous download task for an advertiser's change log.
Create a task to pre-review creative materials for one location.
Create a welcome message within a TikTok advertiser account.
Create a GMV Max campaign from TikTok's official campaign model. Mutation QA must use owned test resources and remain disabled or draft; this action does not add an enabling or publishing status.
Create 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.
Create an irreversible Media Mix Modeling export job after explicit confirmation. Processing can take up to 24 hours, and the request cannot be cancelled through this tool once submitted.
Create a named audience segment or delete one by audience ID.
Create standard Pixel Event configurations and rules; this endpoint does not ingest event occurrences.
Create automated optimizer rules.
Create shop-level customized TikTok posts.
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.
Create a Smart+ ad disabled for review in an existing Smart+ ad group. Use the separate Smart+ ad status tool to enable it.
Create a Smart+ ad group disabled for review in an existing Smart+ campaign. Use the separate Smart+ ad group status tool to enable it.
Create a Smart+ campaign disabled for review. Use the separate Smart+ campaign status tool to enable it after review.
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.
Create up to 10 Smart Fix tasks for advertiser-owned videos.
Permanently delete a catalog from a Business Center.
Permanently delete one TikTok comment. Before calling, confirm the exact advertiser, ad, video, identity, and disposable comment IDs; deletion cannot be undone.
Delete a Custom Conversion configuration; this does not delete ingested events.
Permanently delete a catalog feed.
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.
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.
Delete a Pixel Event configuration; this does not delete ingested event occurrences.
Permanently delete one exact playable asset. Confirm the advertiser and a disposable playable ID before calling.
Permanently delete one exact disposable TikTok test lead. Confirm the owner and lead ID before calling.
Delete an Offline Event Set configuration; this is not an event-ingestion operation.
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.
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.
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.
Permanently delete one uploaded video from an E-commerce catalog. This does not remove copies already synchronized to advertiser creative libraries.
Delete video or image assets owned by a TikTok advertiser account.
Permanently delete up to 100 eligible creative portfolios. Use only explicitly confirmed disposable targets; one invalid ID fails the batch.
Delete between one and 100 custom audiences.
Permanently delete a customized user identity from an advertiser account.
Permanently delete shop-level customized TikTok posts.
Permanently delete a GMV Max session from an advertiser account.
Permanently delete one to ten catalog product sets.
Delete up to 100 Saved Audiences.
Delete negative keywords from one Search Ads campaign or ad group in an authorized advertiser account.
Permanently delete up to 20 Smart+ campaigns, ad groups, or ads.
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.
Discover search keyword ideas and historical search metrics.
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.
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.
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.
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.
Download negative keywords for a campaign or ad group as a spreadsheet file.
Resize or Gaussian-pad an advertiser image.
End an in-progress split test. This transition is irreversible.
Estimate audience size for documented placement, promotion, and targeting settings. Availability may depend on account entitlement.
Generate Smart Text recommendations for an ad group.
Get a creative portfolio by ID. Availability may depend on TikTok entitlement.
Get a suggested bid for an objective and target locations.
Get the current test lead for an Instant Form or direct-message lead source.
Convert an open TikTok URL to an internal TikTok link; availability may require allowlisting.
Get targeting action categories available to an advertiser.
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.
Get one page of ad benchmark dimensions and dynamic numeric metrics, scoped by exactly one ad_ids, adgroup_ids, or campaign_ids filter.
Get up to 50 additional interest categories by ID and language.
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.
Get one page of ad account balances and budgets for a TikTok Business Center, with optional account filters and detailed balance fields.
Get one asynchronous invoice download task and return its documented status and download URL. Use DOWNLOAD_BC_INVOICE for the synchronous invoice file.
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.
Get app conversion events available for advertising optimization.
Get app retargeting events available for audience rules.
Get advertiser binding quota usage for a TikTok identity asset.
Get one page of assets administered by a Business Center.
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.
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.
Get one audience insight dimension for locations or a custom audience.
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.
Get attribution sources and data sources available for a mobile app.
Get content exclusion and vertical sensitivity categories for an objective.
Get contextual tags available for an objective and optional regions.
Get all locations available to an advertiser, with translated names.
Get regions where ads for catalogs in a Business Center can be delivered.
Get available TikTok Shops under an ad account.
Get available verification document types for a region.
Get bid protection history for campaigns or ad groups over a date range.
Get bid protection statuses for up to 200 campaigns or ad groups.
Return one page of an advertiser's blocked-word moderation list and an opaque continuation cursor when more results exist.
Get one page of activity-log records for a Business Center.
Get currencies and registration regions available when creating ad accounts in a Business Center.
Get the assets or members of an Asset Group in a Business Center.
Read the balance of a TikTok Business Center or Payment Portfolio. This action only retrieves financial information and never funds an account.
Get SKAN Dedicated Campaign quota information by ad network.
Get carriers available for ad targeting by country or region.
Get up to 50 top trending product categories and availability metrics for an eligible E-commerce catalog, optionally filtered by category IDs.
Get one page of synchronous catalog product diagnostic information.
Get detected catalog app or pixel event source issues and suggested solutions.
Get daily app or pixel event trends and catalog content-ID match rates.
Get one page of provider-approved category, brand, or availability filter values for product insight endpoints. TikTok returns no pagination metadata, so choose page and page_size explicitly when requesting additional pages.
Get an asynchronous catalog product diagnostic task result.
Get one page of uploaded videos from a catalog.
Read the status and change-log content returned for an advertiser's change-log task.
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.
Return metadata for specified video or image assets in an authorized advertiser's Ads Asset Library.
Get one page of Creative Fatigue Detection results for an ad. This API is available only to allowlisted advertisers.
Get the result of a creative pre-review task.
Return one page of creative material performance with exact JSON-encoded filter and field-selection query parameters.
Get one page of welcome messages within a TikTok advertiser account.
Get CRM Event Sets for an advertiser, optionally filtered by name or ID.
Get current status and modification history for specified owned or shared custom audiences.
Get the advertisers with which a specific TikTok custom audience has been shared, including each sharing status.
Return one page of Custom Conversions configured for a Pixel or app event source.
Get overlap details for a benchmark custom audience and up to four comparison audiences.
Get details for content exclusion or vertical sensitivity category IDs.
Get details for specified contextual tag IDs.
Return one page of Saved Audience details.
Get device models available for ad targeting.
Get issue diagnoses and suggestions for selected ad groups.
Get estimated info of R&F ad groups.
Get apps and pixels bound as event sources to a catalog.
Get all feeds in a catalog or one feed by ID.
Return one page of Business Center form libraries accessible to the connected user.
Get TikTok's recommended GMV Max bid for an eligible advertiser and shop.
Get information for one GMV Max campaign owned by an authorized advertiser.
Get one page of GMV Max campaigns.
Get an advertiser account's exclusive authorization status for a TikTok Shop.
Run one paginated Product or LIVE GMV Max campaign report.
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.
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.
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.
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.
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.
Get information about a mobile app configured for an advertiser.
Get supported TikTok Instant Page event options for an optimization goal.
Return one page of Instant Forms and other TikTok Instant Page types.
Get advertiser interest categories, optionally filtered by placement and special industry.
Get ISP targeting tags supported for specified country- or region-level locations.
Get inventory estimates. Availability may depend on TikTok allowlisting or account entitlement.
Get languages available for ad targeting.
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.
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.
Get supported country or region and currency combinations for catalogs.
Get the results of an asynchronous copy task for a Manual Campaign. Availability may depend on account entitlement.
Get one page of Business Center members assigned to an asset.
Obtain a seven-day signed URL for a completed MMM compressed CSV. This action does not follow the URL or download the sensitive report.
Retrieve MMM request metadata for a UTC+0 date interval. TikTok returns each history item as JSON-formatted text and does not document pagination.
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.
List Offline Event Set configurations; this management endpoint does not ingest offline events.
Get operating-system versions available for targeting.
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.
Get region names, region codes, and calling codes for phone numbers.
Get UTC Pixel Event statistics; this reporting endpoint does not ingest events.
Return one page of Pixels and their configured Pixel Events.
Return one page of playable assets for an advertiser.
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.
Get product linkage details of videos in customized posts.
Get all product sets in a catalog or one product set by ID.
Get one page of catalog products with optional IDs, filters, and ordering.
Get one page of products in a catalog product set.
Get one page of products within a TikTok Shop.
Get R&F time zones.
Get standard or Dynamic CTA recommendations for an advertiser.
Requires a TikTok Business Account token issued by /tt_user/oauth2/token/. The advertiser OAuth connection used by this toolkit cannot call this endpoint.
Get one page of recommended search keywords from exactly one seed type.
Read one page of comments related to a specific TikTok comment and return an opaque continuation cursor. This action does not alter moderation state.
Get automated optimizer rule result details.
Get review info of ad groups.
Get review information for one to 100 ads.
Get one page of automated optimizer rule results.
Get one page of automated optimizer rules by filters.
Get automated optimizer rules by ID.
Get Search Ads Campaign Health diagnoses for an ad group or ads.
Get the identity with Showcase permission under an ad account.
Get one page of products available in a Showcase.
Get the regions targetable by a Showcase-bound identity.
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.
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.
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.
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.
Get one page of Smart+ material overview or breakdown reporting.
Get review information for Smart+ ads or ad materials.
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.
Return one page of webhook subscriptions configured for a developer application.
Get up to ten suggested thumbnail images for an advertiser video.
Get targeting hashtag names and availability by keyword ID.
Get geographical or ISP targeting tag details by targeting ID.
Get locations available for an advertiser's placement, objective, and campaign settings.
Get an advertiser agreement in the requested language.
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.
Get the mobile apps configured for an advertiser.
Return one page of audience application history.
Get one page of assets shared with or by a partner Business Center.
Get a Brand Safety measurement partner's authorization status.
Get the Brand Safety Hub settings configured for an advertiser account.
Get processing counts, errors, warnings, and downloads for a catalog video task.
Get one Custom Conversion configured for a Pixel or app event source.
Get the dynamic quota on active ad groups.
Get the field definitions and metadata for one TikTok Instant Form.
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.
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.
Get the provider-defined lexicon list for a catalog.
Get processing log entries for a catalog feed.
Get message event sets available for instant-messaging ad creation.
Get one page of advertiser music and return a continuation cursor.
Get product audit totals for a catalog.
Get an advertiser's Pangle app block list and its last modification time.
Get processing counts, errors, warnings, and downloads for a product handling task.
Get the current status and statistical results of a split test.
Check whether a comment export task is running, succeeded, or failed. Call the download action only after SUCCEED.
Get one page of TikTok Minis within an ad account.
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.
Get time zones available to advertisers.
Get up to 50 trending products from an eligible E-commerce catalog.
Requires a TikTok Business Account token issued by /tt_user/oauth2/token/. The advertiser OAuth connection used by this toolkit cannot call this endpoint.
Get the results of a Smart Fix task.
Get catalog video packages, optionally restricted to one package ID.
Grant an ad account exclusive authorization for a TikTok Shop.
Invite users to a Business Center and optionally assign advertiser and finance roles.
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.
Ensure the requested link or unlink relationship between a Business Center pixel and advertiser accounts.
List one page of ad accounts linked to one TikTok account asset in a Business Center.
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.
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.
Get one page of budget change audit records for an ad account.
List one page of reusable advertiser qualification records in a Business Center, optionally filtered by verification status.
List one page of advertiser billing transactions accessible through a Business Center, with optional transaction type, fund type, account, and UTC date filters.
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.
Get one page of aggregate Business Center costs and itemized advertiser cost records.
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.
List one page of advertiser-account assets assigned to the authorized user in a specified TikTok Business Center.
Get one page of Asset Groups in a TikTok Business Center.
Get one page of Business Center partners associated with an asset.
Get one page of billing groups in a TikTok Business Center.
Get one page of members in a TikTok Business Center.
Get one page of partners for a TikTok Business Center.
Get one page of ad accounts linked to a TikTok Business Center pixel.
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.
List one page of Business Centers accessible to the connected TikTok authorization, optionally restricted to one Business Center ID.
List one page of campaign labels for an authorized advertiser.
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.
List catalogs in a specified TikTok Business Center, optionally restricted to one catalog ID.
List one provider page of interactive creative portfolios for an advertiser.
List one page of owned and shared custom audiences for an authorized advertiser, optionally restricted to specified audience IDs.
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.
List one page of shop-level customized TikTok posts for GMV Max.
List identities available to an advertiser for GMV Max campaigns.
List one page of authorized or custom-post-eligible TikTok posts for a Product GMV Max campaign.
List the include and exclude audience packages available for an advertiser's Pangle targeting configuration.
List one page of negative keywords for a campaign or ad group in an authorized advertiser account.
List TikTok Shops available to an advertiser for GMV Max campaigns.
Requires a TikTok Business Account token issued by /tt_user/oauth2/token/. The advertiser OAuth connection used by this toolkit cannot call this endpoint.
Requires a TikTok Business Account token issued by /tt_user/oauth2/token/. The advertiser OAuth connection used by this toolkit cannot call this endpoint.
Migrate a catalog from an ad account 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.
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.
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.
Recommend additional interest categories from one or more seed keywords.
Recommend interest and action targeting categories for specified regions and an optional app.
Remove products from a catalog using the ID list for that catalog type.
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.
Return one page of a synchronous TikTok report with dimensions, metrics, advertiser lists, and filters encoded as provider JSON query values.
End a split test by promoting its selected winning ad group and starting that ad group's delivery, which may incur spend.
Save and name a previously uploaded playable asset for an advertiser.
Search for one page of advertiser images and return a continuation cursor.
Generate targeting hashtag recommendations from up to ten seed keywords.
Search for one page of advertiser videos and return a continuation cursor.
Search for or list targeting categories and hashtags for interests and behaviors.
Search geographical targeting tags by location, ZIP-code, or postal-code keywords.
Set or update an advertiser account's Brand Safety Hub settings. Setting cover_all_ad_objectives to true is irreversible and cannot be reverted.
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.
Enable or disable up to 20 Smart+ campaigns, ad groups, or ads. Enabling resources may start ad delivery and spend.
Share controlled creative assets from one advertiser with specified target advertiser accounts.
Share up to ten custom audiences with up to ten advertisers in the same Business Center.
Sign the selected advertiser agreement.
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.
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.
Submit identity and UnionPay account details to verify an eligible business license. This starts a sensitive review with no documented rollback.
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.
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.
Unlink a TikTok account from an ad account in the same Business Center. This destructively removes the existing account association.
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.
Unbind a mobile app, website Pixel, or both from a catalog.
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.
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.
Update the mutable fields of an existing campaign.
Rename, refresh from files, enhance, or convert a custom audience subtype.
Update the name or description of a Custom Conversion configuration.
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.
Update Pixel naming, matching, cookie, or expanded-data-sharing configuration.
Update a Pixel Event configuration; this endpoint does not ingest event occurrences.
Update a product set name, filter conditions, or both.
Update ordinary ads and their documented creative fields.
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.
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.
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.
Update a mobile app configured for an advertiser.
Rename an Asset Group or add or remove its advertiser assets or members.
Update an Offline Event Set configuration; this does not upload or ingest events.
Update an R&F ad group. Availability may depend on TikTok allowlisting or account entitlement.
Update the name of a catalog owned by a TikTok Business Center.
Set one catalog feed schedule to ON or OFF. Read the current status first because TikTok rejects an unchanged value; ON starts recurring ingestion.
Update up to 5,000 products using the fields documented for each catalog type.
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.
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.
Update documented budget or schedule fields for a max delivery or creative boost session. schedule_start_time applies to max delivery sessions.
Update a Business Center member's name, basic role, or finance role.
Update specified lookalike custom audiences.
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.
Update automated optimizer rules.
Update the name or match type of one negative keyword attached to a Search Ads campaign or ad group.
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.
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.
Update an existing Smart+ ad and its material configuration; at least one field to update must be provided.
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.
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.
Enable or disable up to 20 materials belonging to a Smart+ ad. Enabling materials can make them eligible for delivery and spend.
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.
Update the budgets of ad groups. This operation can affect billing, credit, invoices, budgets, contracts, or payments; require explicit approval and an isolated account.
Update an advertiser video name.
Update an advertiser image name.
Enable, disable, or permanently delete campaigns. Enabling may resume ad delivery and spend; postback_window_mode is accepted only while disabling.
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.
Enable, disable, or permanently delete regular or ACO ads. Enabling may resume ad delivery and spend.
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.
Turn automated optimizer rules on or off, or permanently delete them.
Update the start and end time of a split test.
Upload a temporary image, music, video, or playable file by file or URL.
Upload one image, video, or music file through TikTok's start, ordered chunk-transfer, and finish workflow. Chunk signatures are computed internally.
Upload advertiser music or update a Carousel Ads music list.
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.
Upload an advertiser video by local file, URL, temporary file ID, or existing video ID.
Upload a CSV or TXT customer file after verifying its supplied MD5 signature.
Upload an advertiser image by local file, URL, or temporary file ID.
Upload a business certificate image for an ad account through a Business Center where the connected user is an administrator.
Upload up to 5,000 products using the fields documented for each catalog type.
Upload catalog videos from 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.
Upload one or two verification document images.
Get TikTok verification results for a URL.
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.
Sign in to your Dench workspace and open Integrations.
Find TikTok Ads and click Connect — you'll authorize access through TikTok Ads's own sign-in flow. No API keys or code required.
Ask an agent to use TikTok Ads in chat, or call it from an automation.
Manage or disconnect the connection any time from workspace settings.
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.
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.
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.
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.