TikTok Ads
for LuumenAI
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.
Bring TikTok Ads into the same conversation as the systems behind it. LuumenAI reads campaigns, audiences, and delivery status for context, and changes them only through previewed, approved, audited actions.
The TikTok Ads toolbox
131 tools: 83 read, 48 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadGet Change Log Download Task ResultRead the status and change-log content returned for an advertiser's change-log task.
- ReadCheck Advertiser Term StatusCheck whether a TikTok advertiser has signed a specified agreement.
- ReadCheck Change Log Download TaskCheck whether an advertiser change-log download task is processing, successful, or failed.
- ReadCheck File NamesCheck whether one or more image or video file names are already used in an advertiser account.
- ReadCheck GMV Max Occupied Custom Shop AdsCheck which Shopping Ads occupy one TikTok Shop identity or product asset.
- ReadCheck TikTok Shop GMV Max AvailabilityCheck a TikTok Shop's availability for Product GMV Max campaigns.
- ReadCheck MMM Data RequestCheck one MMM export job.
- ReadCheck Smart+ Campaign Copy TaskGet the results of an asynchronous Upgraded Smart+ campaign copy task.
- ReadCheck UnionPay Verification RequirementCheck whether a business license requires UnionPay verification before submitting advertiser verification details.
- ReadGet Ad BenchmarksGet one page of ad benchmark dimensions and dynamic numeric metrics, scoped by exactly one ad_ids, adgroup_ids, or campaign_ids filter.
- ReadGet Advertiser AccountsReturn profile, status, timezone, currency, and other default details for specified authorized TikTok advertiser accounts.
- ReadGet Asset Binding QuotaGet advertiser binding quota usage for a TikTok identity asset.
- ReadGet Bid Protection DetailsGet bid protection history for campaigns or ad groups over a date range.
- ReadGet Bid Protection StatusesGet bid protection statuses for up to 200 campaigns or ad groups.
- ReadGet Business Center Advertiser AttributesGet currencies and registration regions available when creating ad accounts in a Business Center.
- ReadGet Business Center Asset GroupGet the assets or members of an Asset Group in a Business Center.
- ReadGet Business Center BalanceRead the balance of a TikTok Business Center or Payment Portfolio.
- ReadGet Campaign Quota InformationGet SKAN Dedicated Campaign quota information by ad network.
- ReadGet Catalog Category InsightsGet up to 50 top trending product categories and availability metrics for an eligible E-commerce catalog, optionally filtered by category IDs.
- ReadGet Catalog Insight FiltersGet one page of provider-approved category, brand, or availability filter values for product insight endpoints.
- ReadGet Catalog Product Diagnostic TaskGet an asynchronous catalog product diagnostic task result.
- ReadGet Creative AssetsReturn metadata for specified video or image assets in an authorized advertiser's Ads Asset Library.
- ReadGet Creative Pre-Review TaskGet the result of a creative pre-review task.
- ReadGet Custom Audience DetailsGet current status and modification history for specified owned or shared custom audiences.
- ReadGet Custom Audience Sharing LogGet the advertisers with which a specific TikTok custom audience has been shared, including each sharing status.
- ReadGet GMV Max Bid RecommendationGet TikTok's recommended GMV Max bid for an eligible advertiser and shop.
- ReadGet GMV Max Campaign InfoGet information for one GMV Max campaign owned by an authorized advertiser.
- ReadGet GMV Max SessionsGet max delivery or creative boost session details by 1 to 20 exact session IDs.
- ReadGet GMV Max Exclusive AuthorizationGet an advertiser account's exclusive authorization status for a TikTok Shop.
- ReadGet GMV Max ReportRun one paginated Product or LIVE GMV Max campaign report.
- ReadGet MMM Download URLObtain a seven-day signed URL for a completed MMM compressed CSV.
- ReadGet MMM Request HistoryRetrieve MMM request metadata for a UTC+0 date interval.
- ReadGet Showcase IdentityGet the identity with Showcase permission under an ad account.
- ReadGet Smart+ Material ReportGet one page of Smart+ material overview or breakdown reporting.
- ReadGet Smart+ Review InfoGet review information for Smart+ ads or ad materials.
- ReadGet Video Fix TaskGet the results of a Smart Fix task.
- ReadGet In-Second Video PerformanceGet one page of in-second AD or VIDEO performance.
- ReadList Ad Accounts Linked to TikTok AccountList one page of ad accounts linked to one TikTok account asset in a Business Center.
- ReadList Ad GroupsList regular or mixed-automation ad group inventory through TikTok's generic /adgroup/get/ endpoint.
- ReadList AdsList regular or mixed-automation ad inventory through TikTok's generic /ad/get/ endpoint.
- ReadGet Advertiser BalanceGet one page of ad account balances and budgets for a TikTok Business Center, with optional account filters and detailed balance fields.
- ReadList Advertiser Budget ChangesGet one page of budget change audit records for an ad account.
- ReadList Advertiser QualificationsList one page of reusable advertiser qualification records in a Business Center, optionally filtered by verification status.
- ReadList Advertiser TransactionsList one page of advertiser billing transactions accessible through a Business Center, with optional transaction type, fund type, account, and UTC date filters.
- ReadList Business Center Account CostsGet one page of aggregate Business Center costs and itemized advertiser cost records.
- ReadList Business Center Account TransactionsGet 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.
- ReadGet Business Center Activity LogGet one page of activity-log records for a Business Center.
- ReadList Business Center AdvertisersList one page of advertiser-account assets assigned to the authorized user in a specified TikTok Business Center.
- ReadList Business Center Asset GroupsGet one page of Asset Groups in a TikTok Business Center.
- ReadList Business Center Asset PartnersGet one page of Business Center partners associated with an asset.
- ReadList Business Center Billing GroupsGet one page of billing groups in a TikTok Business Center.
- ReadList Business Center MembersGet one page of members in a TikTok Business Center.
- ReadList Business Center PartnersGet one page of partners for a TikTok Business Center.
- ReadList Business Center Pixel LinksGet one page of ad accounts linked to a TikTok Business Center pixel.
- ReadList Business CentersList one page of Business Centers accessible to the connected TikTok authorization, optionally restricted to one Business Center ID.
- ReadList Business Center TransactionsGet one page of Business Center-level cash or grant fund movements, with aggregate charged and paid amounts.
- ReadList Campaign LabelsList one page of campaign labels for an authorized advertiser.
- ReadList CampaignsList regular or mixed-automation campaign inventory through TikTok's generic /campaign/get/ endpoint.
- ReadGet Catalog DiagnosticsGet one page of synchronous catalog product diagnostic information.
- ReadList CatalogsList catalogs in a specified TikTok Business Center, optionally restricted to one catalog ID.
- ReadGet Catalog VideosGet one page of uploaded videos from a catalog.
- ReadGet Creative Welcome MessagesGet one page of welcome messages within a TikTok advertiser account.
- ReadGet Creative Fatigue ResultsGet one page of Creative Fatigue Detection results for an ad.
- ReadList Creative PortfoliosList one provider page of interactive creative portfolios for an advertiser.
- ReadList Custom AudiencesList one page of owned and shared custom audiences for an authorized advertiser, optionally restricted to specified audience IDs.
- ReadList GMV Max Campaign SessionsList active max delivery or creative boost sessions for one Product GMV Max campaign ID.
- ReadList GMV Max Customized PostsList one page of shop-level customized TikTok posts for GMV Max.
- ReadList GMV Max IdentitiesList identities available to an advertiser for GMV Max campaigns.
- ReadList TikTok Shops for GMV MaxList TikTok Shops available to an advertiser for GMV Max campaigns.
- ReadList GMV Max VideosList one page of authorized or custom-post-eligible TikTok posts for a Product GMV Max campaign.
- ReadList Pangle Audience PackagesList the include and exclude audience packages available for an advertiser's Pangle targeting configuration.
- ReadGet Recommended Search KeywordsGet 20 TikTok search-keyword recommendations for a product, service, or brand query.
- ReadList Search Ad Negative KeywordsList one page of negative keywords for a campaign or ad group in an authorized advertiser account.
- ReadGet Showcase ProductsGet one page of products available in a Showcase.
- ReadGet Showcase RegionsGet the regions targetable by a Showcase-bound identity.
- ReadGet Smart+ Ad GroupsList Smart+ ad group details through TikTok's dedicated /smart_plus/adgroup/get/ endpoint.
- ReadGet Smart+ AdsList Smart+ ad details through TikTok's dedicated /smart_plus/ad/get/ endpoint.
- ReadGet Smart+ CampaignsList Smart+ campaign details through TikTok's dedicated /smart_plus/campaign/get/ endpoint.
- ReadGet Trending Catalog ProductsGet up to 50 trending products from an eligible E-commerce catalog.
- ReadList Trending Videos for Commercial MusicRetrieve the top trending TikTok videos that use a Commercial Music Library track in a selected region.
- ReadList Trending Commercial MusicRetrieve up to 100 popular, pre-cleared Commercial Music Library tracks for a TikTok Business Account, region, genre, and popularity window.
- ReadGet Trending Search KeywordsGet the top 20 TikTok search keywords, optionally personalized for a Business Account.
- ReadPreview Smart+ AdGenerate a preview link or iframe for a proposed or existing Upgraded Smart+ ad.
- WriteAppeal Smart+ AdSubmit an appeal for a Smart+ ad review decision. Approval by default
- WriteAssign TikTok Account To AdvertiserLink a TikTok account to an ad account in the same Business Center. Approval by default
- WriteCreate Business Center Asset GroupCreate an Asset Group in a TikTok Business Center, add advertiser assets and members, and optionally assign each member an advertiser access role. Approval by default
- WriteCreate Business Center Organization AccountCreate an Organization Account in an authorized Business Center. Approval by default
- WriteCreate Business Spark AdCreate a campaign, ad group, and Spark Ad in one request. Approval by default
- WriteCreate Catalog Product Diagnostic TaskCreate an asynchronous download task for catalog product diagnostic information. Approval by default
- WriteCreate Catalog Product Set by FileCreate an E-commerce catalog product set from an uploaded CSV file. Approval by default
- WriteCreate Change Log Download TaskCreate an asynchronous download task for an advertiser's change log. Approval by default
- WriteCreate Creative Welcome MessageCreate a welcome message within a TikTok advertiser account. Approval by default
- WriteCreate Creative Pre-Review TaskCreate a task to pre-review creative materials for one location. Approval by default
- WriteCreate GMV Max CampaignCreate a GMV Max campaign from TikTok's official campaign model. Approval by default
- WriteCreate GMV Max SessionCreate a max delivery session for a product or a creative boost session for a video. Approval by default
- WriteCreate MMM Data RequestCreate an irreversible Media Mix Modeling export job after explicit confirmation. Approval by default
- WriteCreate Smart+ AdCreate a Smart+ ad disabled for review in an existing Smart+ ad group. Approval by default
- WriteCreate Smart+ Ad GroupCreate a Smart+ ad group disabled for review in an existing Smart+ campaign. Approval by default
- WriteCreate Smart+ CampaignCreate a Smart+ campaign disabled for review. Approval by default
- WriteCreate Smart+ Campaign Copy TaskCreate and start an asynchronous copy task for an Upgraded Smart+ campaign. Approval by default
- WriteCreate Video Fix TasksCreate up to 10 Smart Fix tasks for advertiser-owned videos. Approval by default
- WriteDelete Business Center Asset GroupDelete one Asset Group from a TikTok Business Center. Approval by default
- WriteDelete Catalog VideoPermanently delete one uploaded video from an E-commerce catalog. Approval by default
- WriteDelete Creative AssetsDelete video or image assets owned by a TikTok advertiser account. Approval by default
- WriteDelete GMV Max SessionPermanently delete a GMV Max session from an advertiser account. Approval by default
- WriteDelete Customized TikTok PostsPermanently delete shop-level customized TikTok posts. Approval by default
- WriteDelete Customized IdentityPermanently delete a customized user identity from an advertiser account. Approval by default
- WriteDelete Search Ad Negative KeywordsDelete negative keywords from one Search Ads campaign or ad group in an authorized advertiser account. Approval by default
- WriteDelete Smart+ ResourcesPermanently delete up to 20 Smart+ campaigns, ad groups, or ads. Approval by default
- WriteDisable Business Center AdvertiserIrreversibly disable one ad account in a TikTok Business Center. Approval by default
- WriteSet Search Ad Negative KeywordsSet negative keywords on Search Ads campaigns or ad groups. Approval by default
- WriteSet Smart+ Delivery StatusEnable or disable up to 20 Smart+ campaigns, ad groups, or ads. Approval by default
- WriteShare Creative AssetsShare controlled creative assets from one advertiser with specified target advertiser accounts. Approval by default
- WriteSubmit UnionPay VerificationSubmit identity and UnionPay account details to verify an eligible business license. Approval by default
- WriteUnassign TikTok Account From AdvertiserUnlink a TikTok account from an ad account in the same Business Center. Approval by default
- WriteUpdate Advertiser AccountUpdate one TikTok ad account's name, contact, company, license, certificate, promotion-link, address, or billing tax-number metadata. Approval by default
- WriteUpdate Advertiser BudgetsConsequential financial action that updates, resets, increments, deducts, or sets minimum budgets for ad accounts in a Business Center. Approval by default
- WriteUpdate CatalogUpdate the name of a catalog owned by a TikTok Business Center. Approval by default
- WriteUpdate Catalog Feed Schedule StatusSet one catalog feed schedule to ON or OFF. Approval by default
- WriteUpdate GMV Max CampaignUpdate supported fields on an existing GMV Max campaign; at least one field to update must be provided. Approval by default
- WriteUpdate GMV Max Campaign CreativesRemove creatives from a GMV Max campaign or add them back. Approval by default
- WriteUpdate GMV Max SessionUpdate documented budget or schedule fields for a max delivery or creative boost session. Approval by default
- WriteUpdate Pangle Block ListUpdate an advertiser's Pangle app block list by adding apps, removing apps, or clearing the existing list before adding replacements. Approval by default
- WriteUpdate Search Ad Negative KeywordUpdate the name or match type of one negative keyword attached to a Search Ads campaign or ad group. Approval by default
- WriteUpdate Smart+ AdUpdate an existing Smart+ ad and its material configuration; at least one field to update must be provided. Approval by default
- WriteUpdate Smart+ Ad GroupUpdate an existing Smart+ ad group's name, bid, budget, schedule, pacing, comment or sharing settings, and audience targeting. Approval by default
- WriteUpdate Smart+ Ad Group BudgetsUpdate immediate total budgets or next-day scheduled daily budgets for Upgraded Smart+ ad groups. Approval by default
- WriteUpdate Smart+ Ad Material StatusEnable or disable up to 20 materials belonging to a Smart+ ad. Approval by default
- WriteUpdate Smart+ CampaignUpdate an existing Smart+ campaign's supported fields; at least one field to update must be provided. Approval by default
- WriteUpload Business Certificate ImageUpload a business certificate image for an ad account through a Business Center where the connected user is an administrator. Approval by default
- WriteUpload Catalog Videos by File URLUpload catalog videos from a file URL. Approval by default
Questions
How does LuumenAI connect to TikTok Ads?
Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in TikTok Ads on its own?
Read actions answer immediately. Anything that writes — appeal smart+ ad, assign tiktok account to advertiser, create business center asset group, create business center organization account, and more — is shown as a plan and requires approval by default, including the 18 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to TikTok Ads — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
ActiveCampaignActiveCampaign is a marketing automation and CRM platform enabling businesses to manage email campaigns, sales pipelines, and customer segmentation to boost engagement and drive growth
ActiveTrailActiveTrail is the world's friendliest email marketing platform, newsletter software and marketing automation software.
AdtractionAdtraction is an affiliate marketing platform for managing partner programs, tracking links, transactions, commissions, statistics, and payments.
AdyntelAdyntel provides an API to retrieve LinkedIn ads for a given company using the company's domain or LinkedIn Page ID.Put TikTok Ads to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.