TikTok Ads Source
Overview
The TikTok Ads Source allows you to collect campaign, ad set, audience, and performance data from your TikTok for Business account into Sourcesible. This source uses OAuth 2.0 for authentication, meaning no manual API keys are required — Sourcesible requests permissions directly through TikTok's authorization portal. Before you begin, ensure you have an active TikTok for Business account with at least one Advertiser Account configured.
TikTok for Business Permission Setup
Sourcesible connects to TikTok Ads via OAuth and requests the following permissions on your behalf during the authorization flow. You do not need to configure these manually — they are pre-scoped by Sourcesible. However, you must ensure your TikTok for Business user has sufficient access to grant each scope.
The following permissions are requested during authorization:
| Permission Scope | Category | Required |
|---|---|---|
| Read Public User Information | View Your Public Info | ✅ Required |
| Ads Management | Access Your Ad Account | ✅ Required |
| Reporting | Access Your Ad Account | ✅ Required |
| Audience Management | Access Your Ad Account | ✅ Required |
You must be logged into TikTok for Business as a user with Admin or Operator role on the Advertiser Account you wish to connect. Standard Analyst roles may not have sufficient permissions to grant Ads Management and Audience Management scopes.
Once authorized, Sourcesible will have ongoing access to your advertising data. You can revoke this access at any time via TikTok For Business User Settings.
Connection Configuration (Inside Sourcesible)
Step 1 — Navigate to Data Sources
- In the left navigation, click Data Sources.
- On the Sources page, scroll to the Advertising section.
- Click the TikTok Ads tile.
Step 2 — Authorize with TikTok for Business
- Sourcesible redirects you to the TikTok for Business authorization portal.
- Confirm the logged-in account shown is correct. If not, click Switch account to change it.
- Review the requested permission scopes:
- Read Public User Information (Required)
- Ads Management
- Reporting
- Audience Management
- Click Confirm to grant access.
All three Ad Account scopes must remain checked. Deselecting any of them may cause data gaps in your pipeline — particularly for Audience syncs and performance reporting.
Step 3 — Complete Source Setup
Once authorization is successful, Sourcesible returns you to the Set up TikTok Ads page. You will see an Authorization Successful confirmation indicating your TikTok Ads account is connected.
- In the Source Name field, enter a descriptive name for this source (maximum 50 characters). This name identifies the source throughout Sourcesible.
- Under TikTok Ads Accounts, click the Select advertiser account dropdown and select the Advertiser Account you want to pull data from.
- Click Save.
If no Advertiser Accounts appear in the dropdown, your TikTok for Business user may not have the Operator or Admin role on any active account. Verify access inside TikTok for Business before retrying.
Test Your Connection
After saving, Sourcesible runs an automatic connection validation. The following are checked:
- OAuth token is valid and has not expired
- The selected Advertiser Account is accessible under the authorized user
- Required permission scopes (Ads Management, Reporting, Audience Management) are active
- Sourcesible can read at least one campaign record from the account
The setup wizard displays a two-step progress indicator — 1 Connect and 2 Set up Destination. A green checkmark on the Connect step confirms the authorization was successful before you proceed.
Next Steps
Once your TikTok Ads Source is saved and validated, you can:
- Set up a Destination — Route your TikTok Ads data to a warehouse or downstream tool using the Set up Destination step in the wizard.
- Create Audiences — Use TikTok Ads data in Sourcesible's Audience builder to segment users based on ad engagement or campaign touchpoints.
- Build Computed Fields — Derive custom traits from TikTok campaign data, such as last ad interaction date or total spend attributed.
- Configure a Pipeline — Schedule recurring syncs from TikTok Ads to keep your data fresh.
Tips and Troubleshooting
No Advertiser Accounts Appear in the Dropdown
Symptom: After successful authorization, the TikTok Ads Accounts dropdown is empty.
Cause: The TikTok for Business user that authorized the connection does not have an Operator or Admin role on any Advertiser Account.
Fix: Log in to TikTok for Business, navigate to Settings → Member Management, and confirm your user is assigned at least the Operator role on the target Advertiser Account. Then return to Sourcesible, click Back, and re-authorize.
Authorization Fails or Redirects Back Without Confirmation
Symptom: After clicking Confirm on the TikTok authorization screen, you are redirected back to Sourcesible without an "Authorization Successful" status.
Cause: The OAuth callback may have timed out, or a browser extension (e.g., ad blocker) blocked the redirect.
Fix:
- Disable any ad blockers or privacy extensions for business-api.tiktok.com and cdp-sit-app.predictive.dev.
- Clear browser cookies for TikTok for Business and retry.
- Ensure you are not using a browser in strict private/incognito mode that blocks third-party redirects.
Previously Connected Account Shows Wrong Advertiser
Symptom: The authorized account is correct, but the Advertiser Account in the dropdown belongs to a different organization.
Cause: Your TikTok for Business login has access to multiple Business Centers or Advertiser Accounts across organizations.
Fix: Use the Switch account option on the TikTok authorization screen to log in with the correct Business Center user, or contact your TikTok Business Center admin to confirm which user should be used for this connection.