Skip to main content
Bring your TikTok ad campaigns into Hiveku to track performance and report alongside your other paid channels.
TikTok Ads uses a manual token-paste flow — not OAuth. You create a developer app in TikTok’s Marketing API portal, generate a long-term access token, and paste it into Hiveku with your advertiser ID.

​
Before You Start

​
Create a TikTok Developer App

1

Open the TikTok Marketing API portal

Go to business-api.tiktok.com. Sign in with your TikTok for Business account.
2

Create a new app

Navigate to My Apps and click Create App. Fill in:
  • App name — e.g., Acme Hiveku
  • App description
  • Required advertiser scopes (typically Ad Account Management, Reporting)
TikTok reviews some apps — most read-only use cases are approved quickly.

​
Generate an Access Token

1

Open your app settings

In My Apps, click into the app you created.
2

Generate a long-term access token

Use the TikTok flow to generate a long-term access token scoped to your advertiser account. In most apps this is done by:
  1. Starting the authorization flow from your app’s dashboard
  2. Signing in with the TikTok account that has advertiser access
  3. Selecting which advertiser account(s) to grant access to
  4. Receiving an access token in the callback (or in the developer portal UI for simpler apps)
Copy the token.
Access tokens are sensitive credentials. Don’t share them or commit them to source control. Rotate them periodically for hygiene.

​
Find Your Advertiser ID

In TikTok Ads Manager, open the account switcher or go to Account Info. The advertiser ID is a numeric string — copy it.
The Advertiser ID is a pure number. Don’t confuse it with the account name or the app ID.

​
Connect in Hiveku

1

Open the integration

Go to Marketing > PPC > Add Connection > TikTok Ads.
2

Paste the token and advertiser ID

  • Access token: the long-term access token from your TikTok developer app
  • Advertiser ID: the numeric ID from Ads Manager
3

Save

Hiveku validates the token against the TikTok Marketing API and saves the connection.

​
What You Get

  • Campaign, ad group, and ad metrics — spend, impressions, clicks, CTR, conversions
  • Creative-level performance
  • Audience breakdowns where available
Data refreshes on an ongoing schedule.

​
Rotating the Token

If your token is revoked or you’re rotating for hygiene:
1

Generate a new token

Go back through the TikTok authorization flow in your developer app.
2

Update in Hiveku

Marketing > PPC > [TikTok Ads connection] > Edit > paste new token > Save.

​
Connect Multiple Advertiser Accounts

Repeat the flow for each advertiser account. If the same TikTok user has access to multiple advertisers, the authorization flow typically lets you select which advertisers to authorize and issues a token scoped to those selections.

​
Verify the Connection

  • Connection status shows Active
  • Campaigns list populates within a few minutes
  • Metrics match TikTok Ads Manager (small delays are expected)

​
Troubleshooting

Regenerate the access token from your TikTok Marketing API app. Make sure you’re copying the access token, not an app secret or refresh token. Update it in Hiveku.
The Advertiser ID is a numeric value only — not the advertiser name or app ID. Find it in TikTok Ads Manager under Account Info, or in the account switcher dropdown.
New tokens can take a few minutes to propagate in TikTok’s backend. If data still doesn’t appear after 30 minutes, verify the campaign dates — some reporting endpoints only return data for campaigns active in the last N days.
Your TikTok developer app may not have the required permissions for certain endpoints (for example, detailed audience data). Check the scopes on your app in the Marketing API portal and request additional permissions if needed — some require TikTok approval.
TikTok enforces per-app rate limits. Space out requests or contact TikTok to request an increase if you have high-volume reporting needs.

​
What’s Next?

Connect Meta Ads

Add Facebook and Instagram campaigns

Connect Google Ads

Add Google Search and Display