TikTok

TikTok Ads · Live

Ask TikTok which creative is actually breaking out.

Read TikTok ad accounts, campaigns, and creative performance so the agent can spot trending content, audit pacing, and pull spend-vs-revenue cuts.

Connect TikTokHow it worksLive
Auth
OAuth
Access
Read-only by default
Plan
Every plan
Freshness
Live — every call hits TikTok's Marketing API
Available on
Every plan

Examples

Questions teams actually ask.

The tools it pulls from are shown inline — every answer in Lumen cites the underlying records it read.

Creative

Which ad creatives in the last 14 days drove the most conversions, and how do their hook rates compare?

pullslistAdsgetCreativeReport
Performance

ROAS by ad group last 7 days, ranked best to worst — flag anything below 1.0.

pullslistAdGroupsgetReport
Pacing

Daily spend vs. budget for every active campaign this week.

pullslistCampaignsgetReport

Scope

What Lumen sees. What it can change.

Read is on by default. Every write is a separate toggle, capped per user, and logged.

Read

What Lumen reads

Lumen calls the TikTok Marketing API using the OAuth token you grant at install, scoped to the advertiser accounts you select. Read scope only by default.

  • Advertiser accounts

    List, currency, timezone, status

  • Campaigns

    Definition, objective, status, budget, schedule

  • Ad groups

    Targeting, optimisation goal, bid, daily budget

  • Ads & creatives

    Video / image creative, copy, status, preview URL

  • Reports

    Impressions, clicks, spend, conversions, ROAS at every level (advertiser / campaign / ad group / ad)

Write · opt-in

What Lumen can write

Lumen does not write to TikTok Ads by default. Pause/unpause and budget changes can be admin-enabled per advertiser account.

    Every call is logged with user, operation, advertiser ID, level, and date range. Exportable as CSV.

    Install

    Connect in under a minute.

    No keys, no call, no app marketplace fine print.

    1. Authorize
      01

      Connect with TikTok OAuth

      In Settings → Integrations → TikTok, click Connect. Sign in to TikTok Business and approve the read scope. The token is stored encrypted.

    2. Pick advertisers
      02

      Choose which advertisers

      Lumen will list every advertiser account your Business Center exposes — pick only the ones the agent should query.

    3. Ask
      03

      Try a warm-up question

      Start with "Top 5 creatives by conversions in the last 14 days" — the agent will pull ads, rank by conversions, and surface the creative previews.

    Connect TikTok. Find the next breakout creative early.

    OAuth. Read-only by default. Pause/budget writes opt-in.

    Connect TikTokBack to all integrations