Connect TikTok Ads

Last updated: May 19, 2026

Connect TikTok Ads

Open /connect/tiktok, click Connect, sign in to TikTok For Business (NOT personal TikTok), authorize Wevion, pick which advertiser accounts to import. Within 15 minutes data starts flowing.

Who is this for

Mediabuyers, managers, admins, owners running TikTok ad campaigns. Manager+ role required.

Before you start

You need:

  • A TikTok For Business account (separate from personal TikTok — sign up at ads.tiktok.com if you don't have one)

  • At least one advertiser account with role: Admin or Operator

  • Browser pop-ups enabled for app.wevion.ai

  • Wevion role: manager, admin, owner, super_admin

How to connect

Step 1: Open the connector page

In the sidebar click Connect → TikTok or visit /connect/tiktok. The page lists already-connected TikTok users (if any) and shows the Connect button.

Step 2: Click Connect

Click Connect. A TikTok OAuth popup opens.

Step 3: Sign in to TikTok For Business

Use your TikTok For Business credentials (not personal TikTok). The OAuth URL is built with app_id, redirect_uri, and state (verified in apps/backend/src/providers/tiktok/domains/auth.provider.ts). TikTok app permissions are configured app-side at TikTok For Business — there's no per-request OAuth scope parameter.

Step 4: Authorize Wevion

TikTok shows the permissions you're granting (typically: ad management, reporting, audience management). Click Authorize.

Step 5: Asset selection

After OAuth, Wevion fetches your accessible advertiser accounts (TikTok calls these "advertiser_id"). Tick which to import.

Click Import selected. Backend creates tiktok_token + tiktok_ad_account rows.

Step 6: First sync

15-min sync starts. First sync pulls: campaigns, ad groups, ads, creatives, audiences, pixels, conversion events, last 90 days insights. Typical duration: 5-15 min.

What you'll see when it works

  • Connector card: green Connected badge

  • Advertiser account count visible

  • Dashboard populates within 15-30 min

  • Ads Manager shows TikTok campaigns

  • Toast: "Imported N campaigns from TikTok"

TikTok For Business vs personal TikTok

Wevion only works with TikTok For Business (the advertising platform). Personal TikTok accounts (where you post videos as a creator) are a separate product. Sign up at ads.tiktok.com for free.

If you signed in with personal TikTok credentials, you'll see "No advertiser accounts found" — that's expected. Sign up for TikTok For Business and retry.

TikTok Business Center

TikTok has a hierarchy similar to Meta's Business Manager:

  • Business Center = top-level container (your company / agency)

  • Advertiser accounts = where ads run (multiple per BC)

  • Users = members of the BC with roles per advertiser account

Wevion's OAuth reads advertiser accounts via your user's BC access. To see additional accounts later: add them to your BC + Wevion picks them up on next sync.

Multiple TikTok users

Same pattern as Meta and Google: different teammates can each connect their own TikTok For Business user. Wevion sees the union. Useful when no single user has access to all advertisers.

Token expiry

TikTok tokens have:

  • Access token: ~24h validity

  • Refresh token: ~1 year validity (long-lived)

Wevion auto-refreshes access tokens silently. Refresh-token failure (rare) requires reconnect — yellow connector card + Reconnect button.

TikTok Events API and Pixel

TikTok has 2 tracking surfaces:

  • TikTok Pixel (browser snippet, like Meta Pixel)

  • TikTok Events API (server-side, like Meta CAPI)

Wevion supports both — see ttk-102.

Common issues

  • OAuth fails after sign in: signed in with personal TikTok, not TikTok For Business. Sign up at ads.tiktok.com.

  • "No advertiser accounts found": your TikTok user lacks access to any advertiser. Verify in TikTok Business Center → Members → roles.

  • OAuth popup blocked: allow popups for app.wevion.ai in browser settings.

  • Sync stuck > 1h: TikTok rate limit. Wait + retry from card menu.

  • Token expired and won't refresh: rare — reconnect via yellow card button. Sync resumes.

  • Ad account in "pending review": TikTok hasn't approved the advertiser yet (24-72h after creation). You can connect but cannot launch until approved.

Security

  • Token encrypted at rest via TikTok encryption key env

  • Wevion only requests what's needed for ad management — no personal TikTok data

  • Revoke any time at TikTok Business Center → Apps section

Related