TikTok Ads
Connect TikTok Ads to build and edit campaigns, ad groups and ads, upload creative, manage audiences and targeting, pull performance reports, and track conversions.
You end up pasting the App ID and App Secret of an approved developer app, read from My Apps > App Detail > Basic Information in the TikTok API for Business portal.
App review before this connector works
A TikTok Marketing API app must be submitted to TikTok for Business and approved - the app status has to reach Live - before real advertisers can authorise it and before tokens return live ad account data.
- Typical wait
- TikTok's developer FAQ is the only vendor-stated figure: "App review may take several days to two weeks after submission." TikTok publishes no separate SLA for Marketing API apps. Business verification, if required, is its own 1-3 business days on top, and a data-security review can extend this further.
- Cost
- No fee for the developer app, sandbox, or the review. Ad spend is separate.
- Blocked until approved
- Live advertiser authorisation. Until the app is Live the OAuth consent URL will not return an auth code for a real advertiser account, so no campaign, ad group, ad, audience, creative or reporting endpoint returns production data. Products and scopes are granted individually, so an approved app still cannot call endpoints outside the scopes it was approved for, and higher-volume or sensitive access (large-scale reporting, audience upload) needs a further request with business verification.
- Works meanwhile
- Register at business-api.tiktok.com/portal, create an app and receive an App ID and secret immediately, then create a sandbox ad account from the developer portal. The sandbox lets you run the full request/response cycle - campaign and ad group creation, reporting shapes, error handling - against simulated data with no review and no ad spend.
Where to apply: business-api.tiktok.com/portal > My Apps > create app, select the Marketing API products and scopes, complete the app information, then Submit for review. Track the result in the app's status field (Under review / Live / Rejected) and, for the advertiser side, the Authorization status column. Business verification is done at developers.tiktok.com under your organisation's Business page.
- Vague use-case descriptions are the top reason for rejection - state exactly what the integration does, who the end users are, and why each scope is needed.
- You must be onboarded to TikTok Business Center; a personal TikTok account is not enough.
- Business verification needs clear digital copies of company registration documents (state business licence or certificate of incorporation, plus an EIN document in the US) and takes its own 1-3 business days.
- A redirect URI mismatch between the app config and the OAuth call fails silently as an invalid auth code after approval.
- The Marketing API app on business-api.tiktok.com is a different registration from a developers.tiktok.com consumer app - credentials are not interchangeable.
- Requesting a rate-limit or volume increase is a separate application after go-live, not part of the initial review.
- Setup time
- 30 min of forms, then up to 6 business days of TikTok review
- Auth
- OAuth authorization
- API base URL
- https://business-api.tiktok.com/open_api/v1.3
- Rate limits
- Every new app starts at the Basic level: 10 queries per second, 600 per minute and 864,000 per day across all endpoints, with tighter per-endpoint caps. Advanced, Premium and Ultimate levels are granted one step at a time on request.
Before you begin
- A TikTok For Business account
- An approved developer profile. Registration is reviewed within three business days and requires a verified company-domain email, since personal and temporary emails are rejected
- A public, fully built company website on a domain you own that matches your email domain. TikTok does not onboard individual developers
- Developer app review, which takes two to three business days. Each developer may hold up to five apps
- At least one advertiser redirect URL you control (up to 10 per app, localhost allowed)
Get your credentials
Register as a developer
Click Become a Developer, fill in your name and a company-domain communication email, click Send Code, then paste the code into Verification Code. Select your user type, enter your company name and company website, choose your Primary Developer Location, and click Submit.
Become a Developer
Register your company before you create an app.
TikTok returns a decision within three business days.
Create a developer app
Click Create an App and give it a descriptive name such as PopMCP Ads Connector. Fill in App description with your intended uses and access controls, then add an advertiser redirect URL.
Create an App
Step 1 of 2. App details.
Up to 10 redirect URLs per app, localhost included.
Select the scope of permission and submit
Under Scope of permission, tick every permission group the connector needs. Click Confirm to submit the app for review.
Scope of permission
Step 2 of 2. Permissions decide which endpoints the app can call.
Scopes can be edited later from My Apps > your app > Scope of permission, with the same review.
Wait for Verification Status to turn approved
Click the red button in the top right and open My Apps. Check the Verification Status column, and click the app name to open App Detail.
My Apps
Each developer can hold up to five apps.
| App name | App ID | Verification Status | Created |
|---|---|---|---|
| PopMCP Ads Connector10 permission groups | 72****9481 | Approved | Mar 4, 2026 |
| Reporting Sandbox2 permission groups | 72****1130 | Under review | Mar 6, 2026 |
A rejected app can be edited and submitted again.
Copy the App ID and App Secret
Open My Apps > App Detail > Basic Information. Copy App ID into PopMCP's App ID field and App Secret into App Secret.
PopMCP Ads Connector
Approved on Mar 4, 2026.
- App ID
- 72****9481
- App Secret
- a1b2****f7e0
- Advertiser redirect URL
- https://app.popmcp.io/oauth/tiktok-ads/callback
- Rate limit level
- Basic
Send the authorization URL to each advertiser you want PopMCP to manage.
Connect in PopMCP
Open your workspace, choose TikTok Ads in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| App IDtext | TikTok API for Business → My Apps → your app → Basic Information → App ID. A numeric id. |
| App Secretsecret | Same screen as the App ID. Stored encrypted, used server-side only, and never sent to the browser or to any tool.Encrypted with AES-256-GCM on save and never shown again. |
https://app.popmcp.com/api/providers/tiktok-ads/callbackIn TikTok API for Business → My Apps → your app → Basic Information, add this exact URL under 'Advertiser redirect URL' and save. TikTok only redirects to URLs registered on the app, so authorization fails until this matches.
PopMCP verifies the credential against TikTok Ads immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Permissions PopMCP requests
These are the scopes sent to TikTok Ads at authorization time.
| Scope | Why PopMCP asks for it |
|---|---|
| Ad Account Management | Lists the advertiser accounts the connector can act on and reads their settings. |
| Ads Management | Creating and editing campaigns, ad groups and ads. |
| Audience Management | Custom and lookalike audience tools plus targeting. |
| Creative Management | Uploading videos and images and reading creative assets. |
| Reporting | Synchronous and asynchronous performance reports. |
| Comment Management | Reading and moderating comments on ads. |
| Lead Generation | Pulling lead form submissions. |
| Business Center Management | Working across assets, members and billing groups in a Business Center. |
| Catalog Management | Product catalogs, feeds and product sets for catalog ads. |
| Event Management | Pixels, web, app and offline events and conversion tracking. |
Verify it worked
PopMCP shows TikTok Ads as Connected. After the advertiser opens the authorization URL, agrees to the Platform Service Agreement, clicks Send Code and enters the emailed verification code, the ad account appears in the connector's account picker and the campaign and reporting tools are listed.
Troubleshooting
An error appears as soon as you try to create an app
Why: Your developer profile has not been approved yet.
Fix: Wait for the registration decision, which takes up to three business days, and re-check that the communication email is on a verified company domain.
The advertiser authorization link fails or shows a generic failure toast
Why: TikTok flagged the request as abnormal, or the advertiser is authorizing a different app than one they were recently verified for.
Fix: Retry later. The advertiser must complete the Send Code email verification again for a new developer app, because a previous verification stays valid for only 48 hours and only for the same app.
Token exchange returns an invalid auth_code error
Why: The auth_code is valid for one hour and can be used only once.
Fix: Have the advertiser open the authorization URL again and complete the connect flow in PopMCP promptly.
A tool returns code 40100
Why: You hit the app's global QPS, QPM or QPD rate limit.
Fix: Back off. QPM limits clear after 5 minutes and QPD limits reset at 00:00 UTC. Apply for a higher level through My Apps > App Detail > Authorization. TikTok raises limits one level at a time.
Calls to an endpoint return a permission error even though the app is approved
Why: The endpoint needs a scope you did not select.
Fix: Go to My Apps > your app > Scope of permission, click the edit icon, add the scope with a justification and submit. It is reviewed in two to three business days.
The registration form rejects your company website
Why: TikTok requires a publicly accessible, fully built site on a domain your company owns that matches the email domain.
Fix: Use the real company domain rather than a shortened link, a social profile or a marketplace storefront, and make sure product and company information loads without a login.
Reference
TikTok
Connect TikTok to post videos and photo carousels, send drafts to your inbox, track how each post performs, and read your profile and follower stats.
YouTube Analytics
Connect YouTube Analytics to see how your channel and videos perform, where viewers come from, who is watching, and which videos win subscribers.