Cryptic error message when configuring campaigns on TikTok Ads? Search below to see what's wrong and how to fix it.
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.
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.
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.
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.
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.
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.
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.
Something went wrong on TikTok's servers. This is not caused by your request but rather a transient issue on their infrastructure.
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.
The `app_id` parameter in your request doesn't correspond to any registered application in the TikTok for Business developer portal.
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).
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
Your CPC, CPM, or oCPM bid is below TikTok's minimum floor for this market. TikTok enforces minimum bids to ensure competitive auction participation.
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.
An ad group with this exact name already exists within the same campaign. TikTok requires unique ad group names per campaign.
You've hit the maximum number of ad groups allowed per campaign (typically 999) or per advertiser account.
The `billing_event` you specified (CPC, CPM, OCPM, CPA) isn't compatible with the chosen optimization goal or campaign type.
The attribution/conversion window specified is not a valid option for TikTok Ads. TikTok supports specific click-through and view-through window combinations.
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.
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).
The video file format you uploaded isn't supported. TikTok accepts MP4, MOV, MPEG, 3GP, and AVI formats for ad creatives.
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).
The video file size exceeds TikTok's upload limit, which is typically 500MB per video creative.
The image creative doesn't meet TikTok's dimension requirements. Image ads require specific aspect ratios and minimum pixel dimensions depending on placement.
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.
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.
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.
You've reached the maximum number of creatives allowed per ad group. TikTok typically allows up to 20 creatives per ad group.
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.
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.
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.
The call-to-action button text you specified isn't one of TikTok's supported CTA options.
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.
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.
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.
The same event is firing multiple times per page load, causing inflated conversion counts and inaccurate optimization signals.
Your server-side Events API call failed authentication. The access token is missing, expired, or doesn't have the required permissions.
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.
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.
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.
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.
For prepay ad accounts, your balance has been fully depleted. All campaigns stop delivering when the balance hits zero.
TikTok requires business verification before you can run ads in certain categories or regions. Your account hasn't completed this step.
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.
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.
The billing currency for your TikTok ad account is permanently set upon account creation and cannot be modified afterward.
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.
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.
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.
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.
The interest targeting ID you specified doesn't exist in TikTok's taxonomy or has been deprecated. TikTok periodically updates its interest categories.
Your excluded audience overlaps so heavily with your targeted audience that the resulting net audience is too small to serve ads to.
The TikTok hashtag you're trying to target either doesn't have enough engagement data or isn't available for targeting in your region.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
The product catalog ID referenced doesn't exist or isn't linked to the advertiser account. This blocks catalog sales campaigns from being created.
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.
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.
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.
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.
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).
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.
The authorization code you entered is not valid. It may be mistyped, already used by another advertiser, or generated for a different purpose.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
Try adjusting your search terms or checking your spelling.
The Automation Engine supercharges your TikTok Ad performance using conditional automation™ via signals like weather, daypart, Amazon item availability and more.