What this is: a 4-minute walkthrough for generating a long-lived TikTok Marketing API access token from a Business Center app, then pasting it into Admaxxer to start syncing campaigns, ad groups, ads, and spend — ready for blended MER, incrementality vs Meta and Google, and creative-grid analysis.
Why analytics-only on TikTok (for now)
Read-first integration. Admaxxer's TikTok integration is currently analytics-only — we read campaigns, ad groups, ads, and insights every 15 minutes, but we don't yet pause or scale TikTok campaigns from the Maxxer AI agent.
Why not yet? TikTok's campaign-management API has stricter rate limits and a different state machine than Meta. We're shipping write actions in v1.5; for v1, you'll get every metric you need to make decisions, then execute the change inside TikTok Ads Manager.
Blended MER unlocks immediately. Even read-only, TikTok spend joins your Meta + Google numbers for true blended ROAS, MER, and incrementality scoring.
Step 1 — Open the TikTok Marketing API portal (~30 sec)
Open business-api.tiktok.com/portal and sign in with the TikTok For Business account that has access to the advertiser accounts you want to track.
If you don't have a Business Center yet, click Create Business at business.tiktok.com first — the Marketing API portal requires a Business Center linkage.
Step 2 — Create a Marketing API app (~1 min)
In the portal, click Become a Developer if prompted, fill in your name + email + business URL.
Click Create an App. Name it Admaxxer Integration, set the description to "Internal analytics tool to sync TikTok ad data into Admaxxer dashboards," and submit.
TikTok approves most internal-tool apps automatically. Once approved, the app shows up in My Apps with a unique App ID and Secret.
Step 3 — Generate a long-lived access token (~1 min)
Open your app from My Apps. Go to the Tools or Authorization tab (the exact label changes; look for "Access Token" or "Authorize").
Click Authorize App. TikTok pops a consent screen asking you to pick which advertiser accounts to grant access to — tick every account you want Admaxxer to read.
After consent, TikTok returns a long-lived Access Token. Copy it. By default these tokens are valid for ~1 year and can be refreshed without user re-consent.
Treat this token like a password — anyone with the raw value can read insights from the authorized advertiser accounts.
Step 4 — Copy your Advertiser ID (~30 sec)
Open ads.tiktok.com and switch to the advertiser account you want to track.
Look at the URL: it ends with ?aadvid=1234567890123456789. That 19-digit number is your Advertiser ID.
If you have multiple advertiser accounts authorized in Step 3, repeat Step 4 for each one — Admaxxer creates one connection per advertiser.
Step 5 — Paste credentials into Admaxxer (~30 sec)
Paste the Access Token (from Step 3) and the Advertiser ID (from Step 4).
Click Connect. Admaxxer validates the token, hits the Marketing API, and shows you a green "Connected" badge plus your last-30-days spend within seconds.
Token TTL — ~1 year, refreshable
TikTok long-lived access tokens are valid for approximately 365 days. Admaxxer warns you 14 days before expiry and offers a one-click rotation flow that re-auths via the same Marketing API app without you needing to recreate it. If your app is deleted or you revoke the authorization in Business Center, the token stops working immediately.
Q: Can the Maxxer AI agent pause a TikTok campaign?
Not in v1 — the TikTok integration is read-only for now. The agent can analyze TikTok spend, ROAS, and incrementality, and tell you which campaigns to pause, but the actual pause happens in TikTok Ads Manager. Write actions ship in v1.5.
Q: My token expired. Now what?
Admaxxer surfaces a banner when a token is <14 days from expiry and emails the workspace owner. Click Reconnect, re-authorize through the same Marketing API app, and paste the new token in — sync resumes within a minute.
Q: Can I track multiple advertiser accounts with one token?
Yes — one app authorization can cover every advertiser you ticked at consent time. Add one Admaxxer connection per Advertiser ID, all backed by the same access token.