Connect TikTok Ads
Connect
- Dashboard → Settings → Integrations → TikTok Ads → Connect.
- Sign in with TikTok For Business and allow the reporting permissions.
- Select the advertiser accounts of this project. A 90-day backfill starts in 30-day chunks.
The Composio-managed TikTok app covers reporting. Pixel-related endpoints may answer
40001 advertiser does not grant you /pixel/list/ with that grant; conversion uploads therefore use
the direct TikTok Events API with a pixel access token (TikTok conversions).
What is imported
| Data | Notes |
|---|---|
| Campaigns, ad groups, ads | names, status, landing page URLs and URL parameters (URL-tag matching) |
| Daily integrated report per ad | spend, impressions, clicks, conversions |
TikTok returns rows for every ad and day, including zero rows; 3x filters rows without spend, impressions and clicks. Days follow the advertiser's time zone (TikTok's default accounts use UTC+1 – noted on daily charts when it differs from the project zone).
Recommended URL settings
Use the UTM template with TikTok's macros
(__CAMPAIGN_ID__, __AID__, __CID__). TikTok appends ttclid when Click ID tracking is
enabled for the pixel.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
Error 40100 in the sync log | TikTok rate limit | retried automatically |
| No accounts after connecting | the login is not a member of the advertiser in Business Center | add the user, reconnect |
Spend 0 for today | report not yet available | compare closed days |