TikTok Ads Error Decoder
Cryptic error message when configuring campaigns on TikTok Ads? Search below to see what's wrong and how to fix it.
Invalid Parameters
One or more parameters in your TikTok Marketing API request are malformed, missing, or contain values that don't match the expected format or enum.
Invalid Access Token
The access token you're sending in the `Access-Token` header is expired, revoked, or was never valid to begin with. TikTok access tokens have a 24-hour lifespan by default.
Authentication Failed
TikTok's API server could not authenticate your request. This is distinct from an invalid token—it means the authentication mechanism itself failed, often because headers are completely missing or malformed.
No Permission
Your app or advertiser account doesn't have the required permissions to access this specific API endpoint or resource. This commonly happens when your app hasn't been granted the right scopes during OAuth.
Resource Not Found
The specific resource you're trying to access (campaign, ad group, ad, creative, etc.) doesn't exist under the advertiser account you specified, or the ID is incorrect.
Method Not Allowed
You're using the wrong HTTP method for this endpoint. For example, sending a GET request to an endpoint that only accepts POST, or vice versa.
Too Many Requests
You've exceeded TikTok's API rate limits. The Marketing API enforces both per-second and per-day rate limits depending on the endpoint and your app tier.
Internal Server Error
Something went wrong on TikTok's servers. This is not caused by your request but rather a transient issue on their infrastructure.
Service Temporarily Unavailable
The specific TikTok API service you're trying to reach is undergoing maintenance or experiencing high load. Different from a generic 500—this indicates a known capacity issue.
Invalid App ID
The `app_id` parameter in your request doesn't correspond to any registered application in the TikTok for Business developer portal.
Campaign Budget Too Low
The daily or lifetime budget you set for this campaign is below TikTok's minimum threshold. For most markets, the minimum daily campaign budget is $50 USD (or equivalent in local currency).
Duplicate Campaign Name
You're trying to create a campaign with a name that already exists within the same advertiser account. TikTok requires unique campaign names per account.
Campaign Limit Exceeded
You've reached the maximum number of campaigns allowed under this advertiser account. TikTok caps campaign creation at around 999 active/paused campaigns per ad account.
Invalid Campaign Type
The `objective_type` or campaign type you specified isn't valid. TikTok supports specific objective types like TRAFFIC, CONVERSIONS, APP_INSTALL, REACH, VIDEO_VIEWS, LEAD_GENERATION, and CATALOG_SALES.
Cannot Modify Archived Campaign
You attempted to update or change settings on a campaign that has been archived. In TikTok Ads, archived campaigns are permanently frozen and cannot be reactivated or modified.
Campaign Objective Mismatch
You're trying to perform an action that conflicts with the campaign's objective. For instance, trying to add app install tracking to a TRAFFIC campaign, or using catalog targeting under a non-CATALOG_SALES objective.
Special Industry Not Declared
Your ad content falls under a special industry category (housing, employment, credit, politics, gambling, etc.) but you haven't declared the special industry qualification on the campaign.
Ad Group Budget Too Low
The ad group's daily or lifetime budget is below TikTok's minimum. Most ad groups require a minimum daily budget of $20 USD (or local equivalent).
Invalid Schedule
The ad group's scheduling parameters are invalid. This could mean the start date is in the past, the end date is before the start date, or the dayparting configuration contains malformed time slots.
Targeting Too Narrow
The combined targeting criteria you've set (age, gender, interests, behaviors, location, device, etc.) result in an estimated audience size that is too small for TikTok to serve ads effectively.
Targeting Too Broad
For certain campaign objectives like catalog sales, TikTok may reject targeting that is excessively broad and would lead to poor ad relevance or wasted budget.
Invalid Placement
The placement configuration for this ad group contains a placement type that isn't supported for the selected campaign objective or the advertiser's region.
Invalid Optimization Goal
The optimization goal you selected doesn't match the parent campaign's objective type. For example, setting `CLICK` optimization under a `CONVERSIONS` campaign, or `INSTALL` under a `TRAFFIC` campaign.
Bid Too Low
Your CPC, CPM, or oCPM bid is below TikTok's minimum floor for this market. TikTok enforces minimum bids to ensure competitive auction participation.
Bid Too High
Your bid is unreasonably high and has triggered TikTok's safety cap. This is usually a bug in automated bidding scripts where a decimal point is misplaced.
Duplicate Ad Group Name
An ad group with this exact name already exists within the same campaign. TikTok requires unique ad group names per campaign.
Ad Group Limit Exceeded
You've hit the maximum number of ad groups allowed per campaign (typically 999) or per advertiser account.
Invalid Billing Event
The `billing_event` you specified (CPC, CPM, OCPM, CPA) isn't compatible with the chosen optimization goal or campaign type.
Invalid Conversion Window
The attribution/conversion window specified is not a valid option for TikTok Ads. TikTok supports specific click-through and view-through window combinations.
Video Too Short
The video creative you uploaded is shorter than TikTok's minimum duration requirement. TikTok typically requires videos to be at least 5 seconds long for In-Feed ads.
Video Too Long
Your video exceeds TikTok's maximum ad duration. The limit varies by placement but is typically 60 seconds for In-Feed ads (some placements allow up to 3 minutes).
Unsupported Video Format
The video file format you uploaded isn't supported. TikTok accepts MP4, MOV, MPEG, 3GP, and AVI formats for ad creatives.
Video Resolution Too Low
The video resolution doesn't meet TikTok's minimum requirements. For In-Feed ads, TikTok requires at least 720×1280 (vertical), 1280×720 (horizontal), or 640×640 (square).
Video File Too Large
The video file size exceeds TikTok's upload limit, which is typically 500MB per video creative.
Invalid Image Resolution
The image creative doesn't meet TikTok's dimension requirements. Image ads require specific aspect ratios and minimum pixel dimensions depending on placement.
Ad Text Too Long
The ad copy text exceeds TikTok's character limits. Ad descriptions are typically limited to 100 characters (including spaces), and display names to 20 characters.
Creative Rejected by Review
TikTok's ad review team has rejected your creative for violating one or more advertising policies. Common reasons include prohibited content, misleading claims, inappropriate imagery, or poor landing page experience.
Invalid Landing Page URL
The destination URL for your ad is malformed, doesn't load, returns an error code, or doesn't match the domain verified in your TikTok Ads account.
Creative Limit Exceeded
You've reached the maximum number of creatives allowed per ad group. TikTok typically allows up to 20 creatives per ad group.
Invalid Thumbnail
The custom thumbnail image you selected for your video ad doesn't meet format or dimension requirements, or it doesn't match the video's aspect ratio.
Music Copyright Issue
The audio track in your video ad contains copyrighted music that you don't have commercial licensing rights for. TikTok's automated content detection flagged the track.
Invalid Display Name
The display name (brand name shown on the ad) contains special characters, is too long, or doesn't match your verified business name in TikTok Business Center.
Invalid Call-to-Action
The call-to-action button text you specified isn't one of TikTok's supported CTA options.
Pixel Not Found
The TikTok Pixel ID referenced in your ad group or conversion event doesn't exist or doesn't belong to the advertiser account you're working with.
Pixel No Activity Detected
TikTok has detected zero events firing from your pixel in the last 24-48 hours. This can block ad group creation or cause delivery issues because TikTok can't optimize without conversion data.
Invalid Conversion Event
The conversion event type you specified for optimization doesn't exist on your pixel, or it's an unsupported event name for the selected objective.
Duplicate Pixel Event
The same event is firing multiple times per page load, causing inflated conversion counts and inaccurate optimization signals.
Events API Authentication Failed
Your server-side Events API call failed authentication. The access token is missing, expired, or doesn't have the required permissions.
Attribution Window Mismatch
There's a mismatch between the attribution window configured on the pixel and what's set in the ad group. This can cause conversion data to not properly attribute back to ads.
Ad Account Suspended
TikTok has suspended your advertising account due to policy violations, suspicious activity, or payment issues. All ads are immediately paused when an account is suspended.
Account Under Review
Your TikTok ad account is currently under manual review by TikTok's trust and safety team. This can happen to new accounts or after significant changes to billing information.
Payment Method Failed
TikTok attempted to charge your payment method but the transaction was declined. This could be due to an expired card, insufficient funds, or the bank blocking the international transaction.
Insufficient Account Balance
For prepay ad accounts, your balance has been fully depleted. All campaigns stop delivering when the balance hits zero.
Business Verification Required
TikTok requires business verification before you can run ads in certain categories or regions. Your account hasn't completed this step.
Invalid Advertiser ID
The `advertiser_id` in your API request doesn't match any active advertiser account, or it belongs to an account your app doesn't have access to.
Timezone Cannot Be Changed
Once an ad account's timezone is set, it cannot be changed. TikTok locks the timezone after the account starts spending to maintain consistent reporting.
Currency Cannot Be Changed
The billing currency for your TikTok ad account is permanently set upon account creation and cannot be modified afterward.
Custom Audience Too Small
The custom audience you created or uploaded has fewer than the minimum 1,000 matched users required by TikTok. Audiences below this threshold cannot be used for targeting.
Lookalike Source Audience Too Small
The source audience for your lookalike audience doesn't have enough members. TikTok requires at least 1,000 matched users in the source audience to build an effective lookalike.
Invalid Audience File Format
The file you uploaded for custom audience creation isn't in the expected format. TikTok requires CSV or TXT files with specific column formatting, and data must be hashed (SHA256) or left plaintext for server-side hashing.
Audience Expired
Your custom audience has passed its retention period and is no longer active. TikTok custom audiences based on pixel data or app events have configurable retention windows.
Invalid Interest Category
The interest targeting ID you specified doesn't exist in TikTok's taxonomy or has been deprecated. TikTok periodically updates its interest categories.
Excluded Audience Overlaps Target
Your excluded audience overlaps so heavily with your targeted audience that the resulting net audience is too small to serve ads to.
Hashtag Audience Unavailable
The TikTok hashtag you're trying to target either doesn't have enough engagement data or isn't available for targeting in your region.
Invalid Report Date Range
The date range you specified for a report request is invalid. This could mean the start date is after the end date, the range exceeds TikTok's maximum (typically 30 or 365 days depending on granularity), or dates are in the wrong format.
Conflicting Report Dimensions
The combination of dimensions (breakdowns like age, gender, placement, country) you requested in your report isn't supported by TikTok. Certain dimension combinations are mutually exclusive.
Invalid Report Metrics
One or more of the metrics (fields) you requested in the report don't exist or aren't available for the specified report level (campaign, ad group, or ad level).
Report Generation Timed Out
Your report request was too large or complex for TikTok to generate within their timeout window. This often happens with very large date ranges, many advertisers, or granular breakdowns.
Data Not Available Yet
You're requesting report data for a very recent time period. TikTok's reporting data has a processing delay of approximately 3-6 hours for standard metrics and up to 72 hours for attribution data.
Ad Not Delivering
Your ad is approved but not generating impressions. This is usually due to an exhausted budget, overly narrow targeting, low bid competitiveness, or the ad being outcompeted in the auction.
Ad Group in Learning Phase
Your ad group hasn't accumulated enough conversion events (typically 50 conversions) within the learning phase window to exit and optimize effectively. Performance may be volatile during this period.
Ad Policy Violation
Your ad has been flagged for violating TikTok's advertising policies. Common violations include misleading claims, prohibited products, inappropriate content, intellectual property infringement, or non-compliant landing pages.
Low Quality Score
TikTok has assigned a low quality score to your ad account based on historical ad performance, policy violations, and user feedback. This reduces your ad delivery priority in auctions.
Frequency Cap Reached
Your ad has reached the frequency cap limit you set, meaning your target audience has already seen the ad the maximum number of times allowed.
Creative Fatigue Detected
TikTok has identified that your creative's performance is declining due to audience saturation. The same users keep seeing the same ad, resulting in lower CTR and engagement over time.
iOS 14+ Tracking Limited
Due to Apple's App Tracking Transparency (ATT) framework, a significant portion of iOS users have opted out of tracking. This limits conversion data, audience size, and optimization accuracy for iOS traffic.
Landing Page Too Slow
TikTok has detected that your landing page loads too slowly on mobile devices (typically over 3 seconds). Slow pages increase bounce rates and can reduce your ad quality score.
Catalog Not Found
The product catalog ID referenced doesn't exist or isn't linked to the advertiser account. This blocks catalog sales campaigns from being created.
Product Set Is Empty
The product set (filtered subset of your catalog) you're targeting contains zero products. This could be due to overly restrictive filters or all products being out of stock/disapproved.
Product Feed Sync Failed
TikTok was unable to fetch or parse your product feed URL. This could be due to the feed URL being unreachable, the file being malformed, or authentication issues.
Product Disapproved
One or more products in your catalog have been disapproved by TikTok's review process. Common reasons include policy violations, missing required attributes, or low-quality images.
Catalog Permission Denied
Your user role or app doesn't have the required permissions to manage or access this product catalog. Catalog management requires specific Business Center role assignments.
Spark Ad Authorization Expired
The authorization code provided by the TikTok creator for using their organic post as a Spark Ad has expired. Authorization codes are valid for a limited period (typically 30, 60, or 365 days).
Spark Ad Post Not Found
The organic TikTok post associated with the Spark Ad authorization code cannot be found. The creator may have deleted the original post or made it private.
Invalid Spark Ad Auth Code
The authorization code you entered is not valid. It may be mistyped, already used by another advertiser, or generated for a different purpose.
Creator Not Eligible
The creator you're trying to partner with through TikTok Creator Marketplace doesn't meet the eligibility requirements (minimum followers, account age, content quality score, or regional availability).
Sandbox Environment Limitation
You're making an API call that isn't supported in TikTok's sandbox environment. The sandbox has limited functionality compared to production—many write operations and certain reporting endpoints are unavailable.
Deprecated API Version
You're calling a TikTok Marketing API version that has been deprecated and sunset. TikTok regularly updates their API and retires old versions after a transition period.
Webhook Delivery Failed
TikTok attempted to deliver a webhook notification to your configured endpoint but received a non-2xx response or a timeout. After multiple failures, TikTok may disable your webhook.
App-Level Rate Limit Hit
Your entire developer application (not just one advertiser) has hit TikTok's global rate limits. This affects all API calls made by your app across all advertiser accounts.
Idempotency Key Conflict
You reused an idempotency key with different request parameters. TikTok uses idempotency keys to prevent duplicate operations, but the key must be paired with identical request data.
Feature Not Available in Region
The TikTok Ads feature or API endpoint you're trying to use isn't available in your advertiser account's region. TikTok rolls out features to different markets at different times.
Concurrent Modification Error
Multiple simultaneous requests tried to modify the same entity (campaign, ad group, or ad) at the same time, creating a conflict. TikTok's API doesn't support concurrent writes to the same object.
Batch Request Partial Failure
In a batch API request, some operations succeeded while others failed. TikTok returns a mixed result where you need to check each individual operation's status.
Async Task Expired
The asynchronous task result (report download, audience processing, etc.) you're trying to retrieve has expired. TikTok keeps async task results for a limited time (usually 24-72 hours).
Invalid Dayparting Schedule
The dayparting (ad scheduling) configuration contains invalid time slots. TikTok expects a specific JSON format with 48 half-hour blocks per day across 7 days, represented as a string of 0s and 1s.
Invalid Deep Link
The deep link URL configured for your app install or app engagement ad is malformed, unreachable, or doesn't match the app registered in TikTok's system.
Identity Type Mismatch
The identity type you selected (Custom Identity vs. Authorized TikTok Account) doesn't match the ad format or campaign requirements. Spark Ads require an authorized TikTok account, while standard ads use custom identity.
Budget Schedule Conflict
The combination of budget type (daily vs. lifetime) and scheduling parameters creates a conflict. For example, you can't use lifetime budget without an end date, or the calculated daily spend from a lifetime budget falls below minimums.
Split Test Configuration Error
Your A/B (split) test setup has conflicting parameters—either the test groups aren't properly isolated, the budget allocation percentages don't sum to 100%, or you're trying to test incompatible variables simultaneously.
No matching errors found
Try adjusting your search terms or checking your spelling.
Want your TikTok Ads to outperform?
The Automation Engine supercharges your TikTok Ad performance using conditional automation™ via signals like weather, daypart, Amazon item availability and more.