Instant Connections

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

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

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.

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.

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

Bind or unbind optimizer rules from existing advertising objects.

Stop sharing a custom audience with an advertiser.

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

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.

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

Check whether a TikTok advertiser has signed a specified agreement.

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

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

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

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

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

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

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

Check one MMM export job. Poll conservatively because TikTok documents up to 24 hours of processing but no polling-rate contract.

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, without polling, whether an asynchronous report task is queued, processing, successful, failed, or canceled.

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

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.

Sign the selected advertiser agreement.

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

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 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 an R&F ad group. Availability may depend on TikTok allowlisting or account entitlement.

Create a mobile app for an advertiser.

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

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 asynchronous export task for an advertiser's blocked words. Save the returned task ID, poll CHECK_BLOCKEDWORD_TASK until SUCCEED, then download it.

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 a Manual Campaign with documented campaign, objective, budget, RTA, and iOS settings.

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

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 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 download task for catalog product diagnostic information.

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

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

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

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 welcome message within a TikTok advertiser account.

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

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

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 lookalike custom audience from an eligible source audience.

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

Create a reusable Saved Audience from targeting criteria.

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 shop-level customized TikTok posts.

Grant an ad account exclusive authorization for a TikTok Shop.

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 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 an Offline Event Set configuration; this does not upload or ingest offline events.

Create automated optimizer rules.

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

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 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 standard Pixel Event configurations and rules; this endpoint does not ingest event occurrences.

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

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 an ad-group or campaign-level split test. Campaign-level tests may require allowlisting.

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

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.

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.

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.

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 a catalog from a Business Center.

Permanently delete a catalog feed.

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

Permanently delete one to ten catalog product sets.

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

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

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 a Custom Conversion configuration; this does not delete ingested events.

Delete between one and 100 custom audiences.

Delete up to 100 Saved Audiences.

Permanently delete a GMV Max session from an advertiser account.

Permanently delete shop-level customized TikTok posts.

Permanently delete a customized user identity from an advertiser account.

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

Permanently delete one exact disposable TikTok test lead. Confirm the owner and lead ID 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.

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.

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.

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.

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

Generate Smart Text recommendations for an ad group.

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

Get available verification document types for a region.

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.

Get issue diagnoses and suggestions for selected ad groups.

Get the dynamic quota on active ad groups.

Get review info of ad groups.

Get estimated info of R&F ad groups.

Get review information for one to 100 ads.

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 information about a mobile app configured for an advertiser.

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 overlap details for a benchmark custom audience and up to four comparison audiences.

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

Get one page of assets administered by a Business Center.

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

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 one asynchronous invoice download task and return its documented status and download URL. Use DOWNLOAD_BC_INVOICE for the synchronous invoice file.

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 one page of assets shared with or by a partner Business Center.

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.

Get a Brand Safety measurement partner's authorization status.

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 regions where ads for catalogs in a Business Center can be delivered.

Get up to 50 top trending product categories and availability metrics for an eligible E-commerce catalog, optionally filtered by category IDs.

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

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

Get processing log entries for a catalog feed.

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 the provider-defined lexicon list for a catalog.

Get supported country or region and currency combinations for catalogs.

Get product audit totals for a catalog.

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

Get an asynchronous catalog product diagnostic task result.

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

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

Get one page of products in a catalog product set.

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

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

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 details for content exclusion or vertical sensitivity category IDs.

Get details for specified contextual tag IDs.

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

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

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 message event sets available for instant-messaging ad creation.

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.

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

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.

Return one page of audience application history.

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

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

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

Get one page of GMV Max campaigns.

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

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 an advertiser account's exclusive authorization status for a TikTok Shop.

Run one paginated Product or LIVE GMV Max campaign report.

Get product linkage details of videos in customized posts.

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.

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.

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.

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.

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

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.

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.

Get one page of TikTok Minis within an ad account.

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.

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

Get automated optimizer rules by ID.

Get automated optimizer rule result details.

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

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

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

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

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

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.

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.

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 UTC Pixel Event statistics; this reporting endpoint does not ingest events.

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

Return one page of playable assets for an advertiser.

Get standard or Dynamic CTA recommendations for an advertiser.

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

Get R&F time zones.

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

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

Get the identity with Showcase permission under an ad account.

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.

Get review information for Smart+ ads or ad materials.

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

Get one page of products within a TikTok Shop.

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

Get targeting hashtag names and availability by keyword ID.

Get geographical or ISP targeting tag details by targeting ID.

Get an advertiser agreement in the requested language.

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

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 the results of a Smart Fix task.

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.

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

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 ad account balances and budgets for a TikTok Business Center, with optional account filters and detailed balance fields.

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.

Get time zones available to advertisers.

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

Get the mobile apps configured for an advertiser.

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

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.

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.

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

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.

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

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.

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

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

Get one page of synchronous catalog product diagnostic information.

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

Get one page of uploaded videos from a catalog.

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.

Get content exclusion and vertical sensitivity categories for an objective.

Get contextual tags available for an objective and optional regions.

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

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

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

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

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

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

Return one page of Saved Audience details.

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.

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

List TikTok Shops 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.

Get one page of automated optimizer rules by filters.

Get one page of automated optimizer rule results.

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

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

Return one page of Pixels and their configured Pixel Events.

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

Get one page of products available in a Showcase.

Get the regions targetable by a Showcase-bound identity.

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 available TikTok Shops under an ad account.

Get carriers available for ad targeting by country or region.

Get device models available for ad targeting.

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

Get languages available for ad targeting.

Get operating-system versions available for targeting.

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

Get targeting action categories available to an advertiser.

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

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

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

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.

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

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

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.

Get a suggested bid for an objective and target locations.

Recommend additional interest categories from one or more seed keywords.

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

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

Generate targeting hashtag recommendations from up to ten seed keywords.

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.

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

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

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.

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

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.

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.

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

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.

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.

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

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.

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

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.

Irreversibly cancel a developer-app webhook subscription.

Update ordinary ads and their documented creative fields.

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 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 R&F ad group. Availability may depend on TikTok allowlisting or account entitlement.

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.

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 a mobile app configured for an advertiser.

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

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.

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

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

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.

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

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

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.

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 a product set name, filter conditions, or both.

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.

Update the name or description of a Custom Conversion configuration.

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

Update specified lookalike custom audiences.

Update an advertiser image name.

Update an advertiser video name.

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 an Offline Event Set configuration; this does not upload or ingest events.

Update automated optimizer rules.

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

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.

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.

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.

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

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

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

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

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.

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 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 start and end time of a split test.

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

Upload one or two verification document images.

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.

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 catalog videos from a file URL.

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

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

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

Upload advertiser music or update a Carousel Ads music list.

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

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

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.

Get TikTok verification results for a URL.

Check validation status and failure details for one playable asset.

Add one or more gifts (donations) to an existing gift batch in Blackbaud Raiser's Edge NXT. Use this tool when you need to: - Append new gifts to an open batch for later processing - Batch multiple donations together before committing them - Add gifts with detailed information (payments, splits, custom fields) Prerequisites: - The batch must already exist (use a create batch action first if needed) - The batch must be in "open" status (not committed) - You need the batch_id (system record ID) and constituent_id (donor ID) for each gift Note: This action returns response details for all HTTP status codes (including errors). Check the status_code field in the response to determine success (200) vs errors (4xx/5xx).

Retrieves comprehensive gift details from Blackbaud Raiser's Edge NXT by gift ID. Use this tool when you need to fetch detailed information about a specific gift including: - Gift amount and currency - Donor/constituent information - Gift type and status - Important dates (gift date, post date) - Associated metadata and custom fields The gift_id is the unique system record ID (integer) that identifies the gift in Raiser's Edge NXT.

Retrieves comprehensive membership details from Blackbaud Raiser's Edge NXT by member junction ID. Fetches detailed information about a specific membership including program name, category/subcategory, membership status and standing (Active, Lapsed), start/expiration dates, dues information, and associated constituent ID. Requires a valid member_junction_id (GUID) that uniquely identifies a membership junction record linking a constituent to a membership program in Raiser's Edge NXT. Returns error information in the response object for graceful error handling in agent workflows.

Retrieves payment transaction details from Blackbaud SKY Payments API. Use this to check transaction status, amounts, payment methods, and error details. Transaction IDs come from payment processing endpoints, checkout callbacks, batch operations, or webhook notifications. Requires: Payments API subscription key (Bb-Api-Subscription-Key) and OAuth Bearer token. This retrieves existing transactions; it does not process new payments.

Tool to interact with Blackbaud OneRoster OAuth2 base endpoints. Use to fetch OpenID configuration (/.well-known/openid-configuration), JWKS key set (publickeys), or obtain an access token via the client credentials grant. Ensure client credentials are configured before using the token operation.

Tool to get brand details by brand ID. Use after obtaining the brand identifier.

Tool to list all brands in the account. Use after confirming account is authenticated.

Tool to create a brand-scoped custom field. Use when you need to define and register a new custom field for a specific brand.

Tool to edit an existing custom field. Use when you need to update a custom field's properties after creation.

Tool to list documents sent on behalf of users. Use when fetching and filtering documents you've sent or on behalf of others.

Tool to edit a draft or sent document. Use when updating files, recipients, or document settings before finalizing the document.

Tool to extend a document's expiry date. Use before signing to prolong a document's deadline.

Tool to list documents in My Documents with filters. Use when you need to fetch and filter documents based on various criteria.

Tool to remove authentication from a document. Use when you need to disable signer authentication on an existing document before the signing process.

Tool to send a document for eSignature. Use when you need to deliver documents to recipients for signing.

Tool to list team documents. Use when a team or account admin needs to retrieve all team documents with optional filters.

Tool to create an embedded request link. Use after specifying title and signers to generate an embeddable URL for in-app document preparation and sending.

Helper action to upload a file to R2 temp via the Xava file pipeline, returning a key that can be passed to FileUploadable fields in other actions (e.g., BrandLogo in brand create).

Tool to get remaining BoldSign API credits count. Use after authenticating your BoldSign account.

Tool to attach a file from a provided URL to a task. The file will be downloaded and attached asynchronously. Use when you need to add a file attachment to a task from a URL source.

Tool to create a new comment on a DART task. Use when you need to add feedback, notes, or discussion to a specific task. Supports markdown formatting and threaded replies via parentId.

Tool to add a time tracking entry to a DART task. Use when you need to record time spent on a specific task. The finishedAt timestamp must be after startedAt.

Tool to create a new doc in Dart. Use when you need to record a new document that the user intends to write down. By default, the created doc will be in the Docs folder unless a specific folder is specified.

Tool to create a new task in DART with title and optional metadata. Use when you need to add a task to a workspace.

Tool to move an existing doc to the trash where it can be recovered if needed. Use when you need to delete a doc without permanently removing it.

Tool to delete an existing task in Dart by moving it to trash. Use when a task needs to be removed but can be recovered later.

Tool to retrieve workspace configuration including dartboards, folders, types, statuses, and more. Use when you need to understand available options in the workspace.

Tool to retrieve an existing doc with metadata and content. Use when you need to access a specific document's details including title, folder, and text content.

Tool to retrieve an existing task with full details including title, dartboard, status, and description. Use when you need to fetch complete information about a specific task.

Tool to list comments for a task with filtering options. Use when you need to retrieve comments on a specific task. Supports filtering by author, text content, date range, and pagination. Can be ordered by date or hierarchical thread structure.

Tool to list docs with filtering and search capabilities. Use when you need to retrieve documents from DART with filters like folder, title, text content, or full-text search. Supports pagination and custom ordering by creation date, update date, or title.

Tool to search help center articles by semantic similarity to query. Use when you need to find relevant help articles based on a short search query (1-5 words). Returns up to two most relevant articles.

Tool to list tasks with powerful filtering options. Use when you need to retrieve tasks from DART with filters like dartboard, status, assignee, tags, priority, dates, or completion state. Supports pagination and custom ordering.

Tool to move a task to a specific position within its dartboard. Use when you need to reorder tasks in a list. Specify either afterTaskId or beforeTaskId to position the task.

Tool to retrieve a skill by its exact title from the workspace. Use when you need to find details about a specific skill including its ID and instructions.

Tool to update an existing doc in Dart. Use when you need to modify a document's title, folder location, or content. Any properties not specified will remain unchanged.

Tool to update an existing task in DART with new properties. Use when you need to modify a task's title, status, assignees, or other attributes. Only properties specified in the request will be updated.