Connect TikTok Ads with a long-lived access token

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)

1. 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.
2. 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)

1. In the portal, click Become a Developer if prompted, fill in your name + email + business URL.
2. 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.
3. 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)

1. Open your app from My Apps. Go to the Tools or Authorization tab (the exact label changes; look for "Access Token" or "Authorize").
2. 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.
3. 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.
4. 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)

1. Open ads.tiktok.com and switch to the advertiser account you want to track.
2. Look at the URL: it ends with ?aadvid=1234567890123456789. That 19-digit number is your Advertiser ID.
3. 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)

1. Back in Admaxxer, open Integrations › TikTok Ads.
2. Paste the Access Token (from Step 3) and the Advertiser ID (from Step 4).
3. 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.

For the authoritative reference, see the official TikTok Marketing API docs.

Security — how Admaxxer stores your token

• AES-256-GCM at rest. The token is encrypted with a workspace-bound key before it touches our database.
• Never logged in plaintext. Application logs only show a 6-character prefix.
• One-click revoke. Disconnect from Admaxxer at any time, or revoke in Business Center > Authorized Apps.

How to disconnect TikTok Ads

Authorized the wrong advertiser? Rotating account ownership? Removing Admaxxer for compliance? Disconnect is a 30-second self-serve flow from inside Admaxxer — no support email required.

1. Open /dashboard/integrations (sidebar › Account › Integrations).
2. Find the TikTok Ads card and hover it — the three-dot menu appears top-right. On mobile the kebab is always visible.
3. Click the kebab › Disconnect. Type your TikTok Advertiser ID (e.g. 7123456789012345678) into the confirm input — this typed-confirm guards against accidental clicks on ad accounts that may carry $100k+/mo in spend.
4. Click the red Disconnect button. Encrypted access token destroyed immediately, pending sync jobs cancelled. The card flips back to Not connected with the original Connect CTA restored.

What stays: historical insights and sync logs, creative-grid history, Sources & Attribution backfills for the prior 90 days, audit trail (Advertiser ID, app, scopes).

What gets deleted: your encrypted TikTok access token (destroyed immediately), pending sync jobs, personal fields stored with the connection, and cached advertiser metadata (display names).

Re-connecting is one click — no data lost for past windows. Sources & Attribution, MER, ROAS, and creative-grid history for every prior date stay intact. Live sync resumes the moment you paste a fresh access token. For belt-and-suspenders revocation outside Admaxxer, also remove the authorization at business.tiktok.com › Authorized Apps.

FAQ

Related

TikTok Ads integration overview · Connect Meta Ads (paste-token) · Connect Google Ads (refresh token) · Documentation home