Connect TikTok Ads

Connect TikTok For Business at /connect/tiktok. OAuth with advertiser account, asset selection, 15-min sync.

Written By Salvatore Sinigaglia

Last updated About 5 hours ago

Connect TikTok For Business at /connect/tiktok. OAuth with advertiser account, asset selection, 15-min sync.

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, admins, owners, and super_admins running TikTok ad campaigns. The mediabuyer role (or admin/owner/super_admin) is required to connect; the manager role is not permitted on the connect page.

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: mediabuyer, admin, owner, or 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 on its own consent screen. Unlike Meta and Google, TikTok's permissions are configured app-side on TikTok For Business rather than requested per-authorization, so the exact list is presented by TikTok at authorize time. Review what TikTok displays, then 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

FAQ

Can I connect my personal TikTok account to Wevion?

No. Wevion only works with TikTok For Business, TikTok's advertising platform — personal TikTok creator accounts won't work. If you sign in with personal credentials during OAuth, you'll see "No advertiser accounts found," which is expected. Sign up for free at ads.tiktok.com, then reconnect at /connect/tiktok.

What role do I need to connect TikTok in Wevion?

Connecting TikTok at /connect/tiktok requires the Wevion role mediabuyer, admin, owner, or super_admin (the manager role is not permitted on the connect page). On the TikTok side, your Business Center user needs Admin or Operator role on at least one advertiser account — otherwise no accounts appear during asset selection.

How long until my TikTok data appears in Wevion after connecting?

The 15-minute first sync starts right after import, typically finishing in 5-15 minutes. Wevion pulls campaigns, ad groups, ads, creatives, audiences, pixels, conversion events, and the last 90 days of insights. Your Dashboard populates within 15-30 minutes and Ads Manager shows your TikTok campaigns.

Do I need to reconnect TikTok when the token expires?

Usually not. TikTok access tokens last ~24h and refresh tokens ~1 year, and Wevion auto-refreshes access tokens silently. Only a rare refresh-token failure needs action — you'll see a yellow connector card with a Reconnect button, and sync resumes within 15 minutes after re-authorizing with the same TikTok user.