← Integrations

TikTok Ads

Coming soon (platform verification) Ads

Reads campaigns, ad groups, ads and daily reports so TikTok spend, pacing and CAC sit next to Google and Meta.

What we pull

• advertiser (currency, time zone)
• campaigns, ad groups, ads with budgets
• daily integrated report (spend, impressions, clicks, conversions, purchase value)

Every record lands as a financial event with source_type, external_id (deduplicated on re-sync) and provenance. Mode: mock.

Signals and sync

• Scheduled sync only (no webhooks).
• Sync interval: daily.
• Health signals: auth_expired, silent (no sync for over twice the interval), error. Each becomes an in-app notification for the owner and shows in Integrations.

Permissions and secrets

• TikTok for Business developer app (Marketing API)
• Advertiser authorization with Reporting and Ad Account read scopes
• Long-lived access token

Secrets are encrypted at rest (AES-256-GCM, per-owner) and never returned by the API; the panel shows only the last 4 characters and the date. Read-only keys wherever the provider offers them.

Availability

Coming soon: the provider is verifying our app. Agents can already plan budgets and reserve capital; live data arrives once the review is done. Use “Notify me” in the panel.

Setup steps

From the Integrator’s owner checklist (Polish; the panel walks you through the same steps).