Meta ads errors
Meta ads error codes and how to fix them
Stuck on an error in Ads Manager or an API tool? Find the code or subcode below. Each page says what the error means, why it happens and how to fix it, based on Meta's own documentation or on how Meta's API answers Kapao.
147 errors
Ad review and policy
Rejected ads, restrictions and temporary blocks.
Ad account, Page and payment
Account problems, Pages, beneficiary and payer, and general publishing errors.
- 3910001Account is experiencing trouble
- 2607Currency not valid for ads
- 3858152Beneficiary and payer information required
- 3858081EU ad set rejected without beneficiary and payer
- 1487470Something went wrong when creating an ad
- 2643066Ad processing error
- 1443121Facebook Page is missing
- 1885029Pages don't match
Access tokens and permissions
Expired tokens, security checks and missing permissions.
- 190Access token expired or invalid
- 458App not installed
- 459User checkpointed (security check)
- 460Password changed
- 463Access token expired
- 464Unconfirmed user
- 467Invalid access token
- 492Invalid session: no role on the Page
- 102Session key invalid
- 10App has no permission for this action
- 200Permission error
- 294ads_management permission required
- 3API method: capability or permission missing
- 1815694User has no permission for this action
- 1713092No write permission for the ad account
- 33Unsupported post request
Rate limits
Too many calls from an app, a user or an ad account.
- 4Application request limit reached
- 17User request limit reached
- 32Page request limit reached
- 341Application limit reached
- 613Calls exceeded the rate limit
- 1996Inconsistent request volume
- 1487742Too many calls from this ad account
- 2446079Ads API user request limit reached
- 5044001Too many create or edit requests per second
- 4841018Too many concurrent edits to the same object
- 1487632Ad set budget changed too often
- 1885172Account spending limit changed too often
- 1487225Ad creation limit reached
- 80004Ads management rate limit (Business Use Case)
- 80000Ads Insights rate limit (Business Use Case)
- 80003Custom Audience rate limit (Business Use Case)
- 80001Too many calls to this Page
- 80002Instagram rate limit (Business Use Case)
- 80005Lead ads rate limit (Business Use Case)
- 80009Catalog management rate limit
- 80014Catalog batch rate limit
Creative, media and posts
Images, videos, enhancements, dynamic creative, posts and links.
- 3858258Image wasn't downloaded
- 1885355Resized image too large
- 1487411File type not supported
- 1885252Video not ready for use in an ad
- 1340029Dynamic creative ad cannot be deleted
- 1885553Only one ad allowed in a dynamic creative ad set
- 1885702Standard creative in a dynamic creative ad set
- 1885998Dynamic creative ad in a standard ad set
- 1885396Call to action not supported with this objective in dynamic creative
- 1373054Call to action type not recognized
- 2446433Call to action link not supported
- 1815563Call to action issue on an ad from an existing post
- 1815952Unable to generate display formats
- 1815629Ad asset values must be unique
- 1815809Each link description must be unique
- 1443048Carousel with several primary texts
- 3858293Background generation needs a product catalog
- 3858504Creative should not include standard enhancements
- 3858082Standard enhancements: enroll_status missing
- 2490472Creative invalid for text generation
- 2490085191x100 crop key no longer available
- 3867105Content can't be used for a partnership ad
- 2446289Selected post is not available
- 2490155Post associated with the ad is not available
- 1885557Ad promotes an unavailable post
- 1487472Post can't be promoted in an ad
- 1885183Post created by an app in development mode
- 2490193Link URL is invalid (link failures)
- 2061006Malformed website URL
- 1860014Ad can't be edited
Instagram and placements
Instagram identity and placement errors.
Campaigns, ad sets and budgets
Budgets, schedules, objectives, optimization and deleted objects.
- 1487860Ad set archived or deleted
- 1487056Ad set deleted: only the name can be edited
- 1487566Campaign deleted: only the name can be edited
- 1885088Ad archived: only the name can be edited
- 1487990Too many archived ads
- 2490588Ad set has reached 50 ads
- 1487007Ad set has reached its end date
- 1487033Campaign end date must be in the future
- 1885272Budget is too low
- 2446375Campaign budget is too small
- 3858558Campaign budget below the minimum
- 1885650Budget too low for the update
- 1885621Budget on both campaign and ad set
- 1885760Ad set must optimize like the campaign's other ad sets
- 2490408Optimization goal not allowed for the campaign objective
- 1885204Bid must be automatic for this optimization
- 2446307Campaign spending limit below the minimum
- 1487929Promoted object is ambiguous
- 1815430No promoted object found
- 2446383Objective requires a website URL
- 2446509Destination type is not valid
- 2490372Shop destination required
- 2446712Store visits optimization no longer available
- 2446867Advantage+ shopping campaign limit per country
- 1487678App and ad set operating system don't match
- 2446880WhatsApp number disconnected
Audiences and targeting
Custom Audiences, terms, age rules, locations and special ad categories.
- 1870034Custom Audience terms not accepted
- 1870090Agree to the Custom Audience terms
- 1870092Agree to the Meta Business Tools terms
- 1870047Audience size too low
- 2654Failed to create custom audience
- 1870065Contains a disabled audience
- 1870088Connection targeting deprecated
- 1870165Targeting not allowed for teens
- 3858064Campaign options not allowed for teens
- 1870199location_types is no longer allowed
- 1487694Targeting category no longer available
- 2446394Detailed targeting options unavailable
- 1870227Advantage+ audience flag required
- 3858788Excluding a radius around a city no longer available
- 2909034Locations outside the special ad category countries
- 2909035Audience breaks special ad category rules
- 2909052Radius too small for a special ad category
Catalogs and lead forms
Product sets and instant forms.
Reporting (Ads Insights)
Errors when reading results and reports.
General errors
Unknown errors, invalid parameters and temporary failures.
How to read a Meta error
An API error has a code (the main error number, for example 100 for an invalid parameter) and often an error_subcode with the exact reason. Look up the subcode when there is one.
error_user_title and error_user_msg are Meta's message for people, in the language of the request. fbtrace_id is Meta's internal ID: include it when you contact Meta support.
Meta says error handling should rely on the codes only, because the description text can change without notice.
Kapao is an independent tool, not a Meta product. Meta can change its error codes and messages without notice; check the source if something does not match.