TikTok Ads
TikTok for Business ad accounts: advertisers, campaigns, ad groups, reporting and lead gen.
Lead Generationoauthproxylead_sync
Connect TikTok Ads
TikTok Ads uses OAuth for authentication. Redirect your user to the login URL to start the authorization flow. After the user authorizes access, the callback is handled automatically.
# Redirect user to start OAuth flow
GET /auth/tiktok_ads/login?account_id=YOUR_ACCOUNT_ID&redirect_uri=https://your-app.com/callback
# Callback handled automatically at
GET /auth/tiktok_ads/callback
Subscribe to Webhooks
Set up a webhook subscription to receive real-time events from TikTok Ads:
POST /connect/v1/webhooks/tiktok_ads/subscribe
# Headers
Authorization: YOUR_JWT_TOKEN
Content-Type: application/json
# Body
{
"url": "https://your-app.com/webhook"
}
List your existing webhook subscriptions:
GET /connect/v1/webhooks/tiktok_ads/subscriptions
# Headers
Authorization: YOUR_JWT_TOKEN
Make API Calls via Proxy
Use the proxy endpoint to make authenticated API calls to TikTok Ads without managing tokens yourself. Calimatic Connect handles credential injection and token refresh automatically.
POST /connect/v1/proxy/tiktok_ads
# Headers
Authorization: YOUR_JWT_TOKEN
Content-Type: application/json
# Body
{
"method": "GET",
"path": "/me"
}
Check Status
Verify whether your TikTok Ads connection is active and credentials are valid:
GET /connect/v1/providers/tiktok_ads/status
# Headers
Authorization: YOUR_JWT_TOKEN
Disconnect
Remove the TikTok Ads connection and revoke stored credentials:
DELETE /connect/v1/providers/tiktok_ads/disconnect
# Headers
Authorization: YOUR_JWT_TOKEN