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.

    Access tokens and permissions

    Expired tokens, security checks and missing permissions.

    Rate limits

    Too many calls from an app, a user or an ad account.

    Creative, media and posts

    Images, videos, enhancements, dynamic creative, posts and links.

    Instagram and placements

    Instagram identity and placement errors.

    Campaigns, ad sets and budgets

    Budgets, schedules, objectives, optimization and deleted objects.

    Audiences and targeting

    Custom Audiences, terms, age rules, locations and special ad categories.

    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.

    Publish your next batch in minutes

    $29 per user per month. 14 day free trial, no credit card. Never a percentage of your ad spend.