Skip to main content

​
Overview

Connecting TikTok Ads lets the dashboard:
  • Create, update, pause, resume, and remove campaigns, ad groups, and ads.
  • Upload creative assets (image, video) into the connected advertiser.
  • Metrics sync for this platform is not available yet.
  • Run native creative experiments via TikTok’s A/B test feature.
  • Receive realtime ad-disapproval and account-status events via webhooks.
The integration uses the Marketing API v1.3 with OAuth 2.0 authentication.

​
Prerequisites

Before connecting, make sure you have:
  1. A TikTok For Business account with at least one advertiser.
  2. Admin or operator role on the advertiser.
  3. (Optional) A TikTok Pixel or Events API source for conversion tracking.

​
OAuth scopes

The connection requests the standard advertiser-management scope set required to read account info, manage campaigns, and pull reports.

​
Connect

  1. Open the Paid UA → Integrations page in the dashboard.
  2. Click Connect on the TikTok Ads tile.
  3. Sign in with the TikTok For Business account.
  4. Approve the requested scopes.
  5. Pick the advertiser to use.

​
Token lifetime

TikTok access tokens expire 24 hours after issuance with no refresh extension. An automated token refresh rotates tokens 6 hours before expiry. If rotation fails, the integration is downgraded to read-only and a banner appears on the connections page until you reauthorize.

​
What lives on the platform vs the dashboard

​
Webhooks

TikTok posts ad-status and account-status events to:
Signature: HMAC-SHA256 over the raw body, verified with a platform-managed signing secret configured by your administrator. A previous signing secret is also accepted during key rotation.

​
Disconnect

Disconnecting revokes the dashboard’s stored OAuth token and stops all background syncs. Campaigns created via the dashboard remain on the platform — disconnect does not pause or delete them. While the account is disconnected, AppDNA can’t pause, resume or change its campaigns, and they keep running and spending on TikTok. Pausing one from its campaign page asks you to reconnect. If you can’t reconnect, Stop tracking in AppDNA on that page takes the campaign out of the Daily Budget Cap total and the guardrails. It doesn’t pause or delete anything on TikTok; pause it there to stop the spend. Once the account is connected again, Track again on that page brings the campaign back as active, so it counts in the Daily Budget Cap total at once; if it’s paused on TikTok, pause it in AppDNA afterwards. Until then, AppDNA refuses every other change to it.

​
Limits

  • Token lifetime: 24 hours; rotated automatically 6 hours before expiry.
  • Rate limits: per-advertiser token bucket; 429s back off via the platform-specific retry header.
  • Creative size: image up to 30 MB, video up to 500 MB; format-specific limits enforced server-side before upload.