TikTok for Business
API versie: Business API v1.3 · Officiële docs: https://business-api.tiktok.com/portal/docs
OAuth-flow
TikTok variant: callback levert `auth_code` (niet `code`), token exchange via JSON body `{app_id, secret, auth_code}` — niet form-encoded
| Authorization URL | https://business-api.tiktok.com/portal/auth |
| Token URL | https://business-api.tiktok.com/open_api/v1.3/oauth2/access_token/ |
| Token body format | application/json |
| Scopes | Ad Account Management, Ads Management, Reporting |
| API base URL | https://business-api.tiktok.com/open_api/v1.3 |
| Auth header | Access-Token: <token> (NIET Authorization: Bearer) |
Wat wordt gesynchroniseerd
- Advertisers (ad accounts)
- Campaigns
- Daily basic reports per AUCTION_CAMPAIGN (impressions, clicks, spend, reach, conversion)
Sync interval: Elke uur
Rate limits
TikTok antwoordt met `code` in elke response (0 = success); we backoff bij 50000-series errors
Bekende beperkingen
- TikTok scopes zijn numerieke permission IDs in de developer portal — labels in onze code zijn informatief
- Spark Ads (gepromote organic posts) vereisen extra TCM authorization — niet default
- TikTok Shop integratie is separate API, niet in MVP
Verbinden
- Ga in je workspace naar
/connections - Klik op "Verbinden" bij TikTok for Business
- Log in bij TikTok for Business en geef toestemming voor de scopes
- Selecteer welk ad-account je wilt synchroniseren
- De eerste sync start automatisch; volgende syncs draaien elke uur