TikTok Lead Gen
Import leads from TikTok Lead Generation ads.
Lead Generationoauthproxylead_sync
Connect TikTok Lead Gen
TikTok Lead Gen 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 Lead Gen:
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 Lead Gen 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 Lead Gen connection is active and credentials are valid:
GET /connect/v1/providers/tiktok_ads/status
# Headers
Authorization: YOUR_JWT_TOKEN
Disconnect
Remove the TikTok Lead Gen connection and revoke stored credentials:
DELETE /connect/v1/providers/tiktok_ads/disconnect
# Headers
Authorization: YOUR_JWT_TOKEN