Amazon Ads Error Decoder

Cryptic error message when configuring campaigns on Amazon Ads? Search below to see what's wrong and how to fix it.

403 Forbidden API Validation

Forbidden Access

This happens when your application tries to access an Amazon Ads API resource without the proper permissions, or if the advertiser's profile has been unlinked from your developer account.

Error 404 NotFound API Validation

Resource Not Found

Amazon couldn't find the specific entity you are looking for (like a Campaign ID, Ad Group, or Keyword). This usually means the ID is incorrect, or it belongs to a completely different advertising profile.

429 TooManyRequests API Validation

Rate Limit Exceeded

You're moving too fast! Amazon's API has strict rate limits to prevent server overload, and you've submitted too many requests in a specific time window.

500 InternalServerError API Validation

Internal Server Error

Don't worry, this one usually isn't your fault! An unexpected error occurred on Amazon's internal servers while trying to process your request.

503 ServiceUnavailable API Validation

Service Unavailable

The Amazon Ads API service is temporarily down, most likely undergoing scheduled maintenance or experiencing exceptionally high server load.

422 UnprocessableEntity API Validation

Unprocessable Entity

Your request was formatted perfectly (syntactically correct JSON), but Amazon couldn't process it because it didn't make logical sense—like trying to pause a campaign that is already permanently archived.

INVALID_ARGUMENT API Validation

Invalid Argument

One of the parameters in your payload is malformed or isn't an accepted value for that field (for example, passing `Paused` instead of `PAUSED`).

MALFORMED_REQUEST API Validation

Malformed Request

The server couldn't understand your request because the JSON payload itself is broken, missing a comma, or improperly formatted.

UNSUPPORTED_MEDIA_TYPE API Validation

Unsupported Media Type

You forgot to tell Amazon what kind of data you're sending, or you're sending it in the wrong format.

REQUEST_TOO_LARGE API Validation

Request Payload Too Large

You're trying to send too much data at once. The size of your JSON payload has exceeded Amazon's maximum allowed limits.

PORTFOLIO_OUT_OF_BUDGET Advertising Constraints

Portfolio Out of Budget

The portfolio budget has been completely exhausted.

AD_GROUP_OUT_OF_BUDGET Advertising Constraints

Ad Group Out of Budget

The ad group budget has been completely exhausted.

ACCOUNT_OUT_OF_BUDGET Advertising Constraints

Account Out of Budget

The account budget has been completely exhausted.

PAYMENT_FAILURE Account & Billing

Payment Method Failed

The credit card on file has failed to charge.

OUT_OF_BALANCE Account & Billing

Account Out of Balance

Prepaid funds have been depleted to zero.

CAMPAIGN_ARCHIVED State Management

Campaign is Archived

Cannot perform operations on an archived campaign.

CAMPAIGN_PAUSED State Management

Campaign is Paused

The campaign is paused and not delivering metrics.

DUPLICATE_CAMPAIGN Validation

Duplicate Campaign

A campaign with these details already exists.

AD_GROUP_ARCHIVED State Management

Ad Group is Archived

Cannot perform operations on an archived ad group.

AD_GROUP_PAUSED State Management

Ad Group is Paused

The ad group is paused and not delivering metrics.

DUPLICATE_AD_GROUP Validation

Duplicate Ad Group

A ad group with these details already exists.

KEYWORD_ARCHIVED State Management

Keyword is Archived

Cannot perform operations on an archived keyword.

KEYWORD_PAUSED State Management

Keyword is Paused

The keyword is paused and not delivering metrics.

DUPLICATE_KEYWORD Validation

Duplicate Keyword

A keyword with these details already exists.

PRODUCT_AD_ARCHIVED State Management

Product Ad is Archived

Cannot perform operations on an archived product ad.

PRODUCT_AD_PAUSED State Management

Product Ad is Paused

The product ad is paused and not delivering metrics.

DUPLICATE_PRODUCT_AD Validation

Duplicate Product Ad

A product ad with these details already exists.

TARGET_ARCHIVED State Management

Target is Archived

Cannot perform operations on an archived target.

TARGET_PAUSED State Management

Target is Paused

The target is paused and not delivering metrics.

DUPLICATE_TARGET Validation

Duplicate Target

A target with these details already exists.

PORTFOLIO_ARCHIVED State Management

Portfolio is Archived

Cannot perform operations on an archived portfolio.

PORTFOLIO_PAUSED State Management

Portfolio is Paused

The portfolio is paused and not delivering metrics.

DUPLICATE_PORTFOLIO Validation

Duplicate Portfolio

A portfolio with these details already exists.

DRAFT_CAMPAIGN_ARCHIVED State Management

Draft Campaign is Archived

Cannot perform operations on an archived draft campaign.

DRAFT_CAMPAIGN_PAUSED State Management

Draft Campaign is Paused

The draft campaign is paused and not delivering metrics.

DUPLICATE_DRAFT_CAMPAIGN Validation

Duplicate Draft Campaign

A draft campaign with these details already exists.

NEGATIVE_KEYWORD_ARCHIVED State Management

Negative Keyword is Archived

Cannot perform operations on an archived negative keyword.

NEGATIVE_KEYWORD_PAUSED State Management

Negative Keyword is Paused

The negative keyword is paused and not delivering metrics.

DUPLICATE_NEGATIVE_KEYWORD Validation

Duplicate Negative Keyword

A negative keyword with these details already exists.

INVENTORY_OUT_OF_STOCK Product Eligibility

Inventory Out of Stock

The specific ASIN tying to this ad currently has absolute zero sellable inventory inside Amazon's fulfillment network.

NOT_BUY_BOX_WINNER Product Eligibility

Not Buy Box Winner

Your offer for this ASIN isn't currently winning the Featured Offer (the Buy Box). Because Amazon prioritizes customer experience, Sponsored Products ads only show if the advertiser holds the Buy Box.

ASIN_NOT_ELIGIBLE Product Eligibility

ASIN Not Eligible

Amazon has flagged this product as ineligible for advertising. This usually happens due to category restrictions, missing images, suppressed listings, or a sudden policy violation flag on the catalog page.

HAZMAT_RESTRICTION Product Eligibility

Hazmat Restriction

Amazon has classified this specific item as a hazardous material. Hazmat items are heavily restricted from utilizing standard advertising placements.

ADULT_PRODUCT Product Eligibility

Adult Product Restriction

The product has been flagged as 'Adult' in nature in the Amazon catalog backend. Adult novelties and related products are barred from nearly all Amazon Ads placements.

CLOSED_CATEGORY Product Eligibility

Restricted Category

This product lives in a retail category that is currently gated off from Sponsored Ads (for instance, certain medical devices, weapons, or fine art).

MISSING_IMAGE Product Eligibility

Missing Main Image

Your ASIN lacks a high-quality main image on its product detail page, which is a hard requirement to generate a Sponsored Ad creative.

NO_PURCHASABLE_OFFER Product Eligibility

No Purchasable Offer

There is literally no active offer for this ASIN on Amazon right now, or the listing is entirely suppressed from search.

BRAND_MISMATCH Product Eligibility

Brand Authorization Mismatch

You're trying to advertise an ASIN for a brand that your advertising account isn't officially authorized to represent.

LOW_INVENTORY_WARNING Product Eligibility

Low Inventory Warning

While this isn't strictly an error that stops ads, it's a massive warning that your FBA stock is incredibly low.

INVALID_MATCH_TYPE_BROAD Targeting

Invalid Match Type: BROAD

The match type BROAD is not valid for this specific op.

INVALID_MATCH_TYPE_PHRASE Targeting

Invalid Match Type: PHRASE

The match type PHRASE is not valid for this specific op.

INVALID_MATCH_TYPE_EXACT Targeting

Invalid Match Type: EXACT

The match type EXACT is not valid for this specific op.

INVALID_MATCH_TYPE_NEGATIVE_EXACT Targeting

Invalid Match Type: NEGATIVE_EXACT

The match type NEGATIVE_EXACT is not valid for this specific op.

INVALID_MATCH_TYPE_NEGATIVE_PHRASE Targeting

Invalid Match Type: NEGATIVE_PHRASE

The match type NEGATIVE_PHRASE is not valid for this specific op.

INVALID_MATCH_TYPE_NEGATIVE_BROAD Targeting

Invalid Match Type: NEGATIVE_BROAD

The match type NEGATIVE_BROAD is not valid for this specific op.

KEYWORD_TOO_LONG Targeting

Keyword Too Long

The keyword phrase you submitted contains too many characters or too many spaces.

DISALLOWED_CHARACTERS Targeting

Disallowed Characters

The keyword contains punctuation, emojis, or symbols that Amazon's search engine refuses to process.

INVALID_TARGETING_EXPRESSION Targeting

Invalid Targeting Expression

Your Product Attribute Targeting (PAT) JSON expression syntax is totally malformed.

TARGETING_CLAUSE_TOO_BROAD Targeting

Clause Too Broad

Amazon rejected your category targeting request because it would target practically millions of items and degrade the auction.

NEGATIVE_KEYWORD_CONFLICT Targeting

Negative Keyword Conflict

You're trying to add a positive keyword that exactly clashes with an existing Negative Keyword right in the same Ad Group.

MAX_KEYWORDS_EXCEEDED Targeting

Maximum Keywords Exceeded

You hit the hard limit for how many active/paused keywords can exist inside this single specific Ad Group (usually max 1000).

RESTRICTED_KEYWORD Targeting

Restricted Keyword

The keyword explicitly violates Amazon's policy rules (often involving prescription drug claims, adult terms, or restricted brand names).

BID_TOO_LOW Bidding & Budgets

Bid Too Low

The CPC bid submitted is literally below Amazon's mandatory platform minimum required to participate in the auction (often $0.02 or local equivalent).

BID_TOO_HIGH Bidding & Budgets

Bid Too High

The bid is irrationally high, triggering Amazon's safety ceiling checks. This is usually due to a decimal/math error in scripts.

BUDGET_TOO_LOW Bidding & Budgets

Budget Too Low

The campaign's daily budget is set below Amazon's absolute minimum threshold (usually $1.00 USD).

INSUFFICIENT_FUNDS_FOR_BID Bidding & Budgets

Bid Exceeds Budgets

Your requested CPC bid is mathematically higher than the entire daily budget attached to the campaign!

INVALID_BID_STRATEGY Bidding & Budgets

Invalid Bid Strategy

You tried applying a bidding strategy that isn't supported by this campaign variant (like applying 'Rule-based bidding' to a generic Sponsored Brands auto-campaign).

MISSING_DEFAULT_BID Bidding & Budgets

Missing Default Bid

You are trying to create an Ad Group but totally forgot to supply the mandatory 'defaultBid' monetary value.

PLACEMENT_MODIFIER_INVALID Bidding & Budgets

Invalid Placement Modifier

Your Top of Search or Product Page bid modifiers violate percentage boundaries (they usually must exclusively be integers between 0% and 900%).

MULTIPLE_BID_MODIFIERS Bidding & Budgets

Conflicting Bid Modifiers

You are sending a request containing conflicting overlapping bid strategies in a single payload.

ROAS_TARGET_UNACHIEVABLE Bidding & Budgets

ROAS Target Unachievable

Your input for a Rule-Based Bidding target ROAS is syntactically invalid or mathematically unlikely based on historical data ceilings.

ASIN_OUT_OF_STOCK_SD System Specific

Sponsored Display ASIN stockout

The product assigned to a specific Sponsored Display ad has gone absolutely out of stock in the Amazon Fulfillment Network.

REPORT_NOT_READY System Specific

Report Not Ready

You generated a request for an Amazon Ads bulk data report, but you're attempting to download it too quickly before Amazon's servers have finished compiling the file.

SB_CAMPAIGN_NO_BUDGET System Specific

SB Campaign out of funds

Your Sponsored Brands campaign has rapidly eaten through its pre-allocated daily limit constraint faster than expected.

REPORT_EXPIRED System Specific

Report Expired

You waited too long to download an API report! Amazon generally deletes the temporary download files from their servers after a specific timeframe to save storage space.

PAT_BRAND_NOT_FOUND System Specific

Targeted brand ID not recognized

You attempted to use Product Attribute Targeting (PAT) to hit a specific brand, but the Brand ID you passed does not exist in Amazon's current catalog entity map.

BULK_UNSUPPORTED System Specific

Unsupported Column in Bulk Sheet

You attempted to upload an Amazon Bulk Operations spreadsheet, but it contained a column header that is misspelled, deprecated, or completely unrecognized by the server.

API_VERSION_DEPRECATED System Specific

Deprecated API endpoint

Amazon updates their API roughly every few months and phases out older endpoints (like moving from v2 to v3). The route you are calling has been historically sunset.

DUP_PORTFOLIO System Specific

Duplicate Portfolio Name

You tried to create or rename a portfolio, but another portfolio with the exact identical spelling already exists inside of your specific advertising account.

INELIGIBLE_PAYMENT System Specific

Credit card restricted

The payment method securely attached to your Amazon seller account has been flagged as ineligible (perhaps it's an unaccepted prepaid debit card or has a strict fraud lock on it).

TOKEN_MALFORMED System Specific

JWT Bearer Malformed

The access token included in your HTTP Authorization header is incorrectly formatted, structurally corrupted, or incomplete.

SCOPE_MISSING System Specific

Profile Scope Header Missing

You fired an API request to an endpoint that explicitly requires the `Amazon-Advertising-API-Scope` header to know *which* agency client to act on, but you forgot it entirely.

API_CLIENT_SUSPENDED System Specific

App Suspended

Uh oh. Amazon has actually suspended your internal Developer Client application, possibly for violating Terms of Service or massive endpoint abuse.

DSP_ONLY_ASIN System Specific

ASIN only eligible for DSP

Standard Sponsored Products/Brands are not allowed to be utilized for this retail product category; it is locked exclusively to Amazon Demand-Side Platform (DSP) buys.

UNKNOWN_ERROR System Specific

Unknown Framework Error

Amazon's servers encountered an alien problem they couldn't confidently classify using a standard internal error code dictionary.

AD_GROUP_NAME_DUPLICATE System Specific

Duplicate Ad Group Name

Every Ad Group inside a specific Campaign must have a completely unique name. You just tried creating one that matches a name you already used.

CAMPAIGN_START_DATE_MISSING System Specific

Missing Campaign Start Date

When initially creating a campaign, the API enforces a strict requirement that you dictate *when* it's allowed to begin spending, but your payload lacked this.

INVALID_BID_TYPE System Specific

Invalid Bid Type Schema

The bid value submitted was rejected because it inherently violated parameter types—for instance, sending the bid dynamically wrapped as a string value rather than a true float/decimal.

Want your Amazon Ads to outperform?

The Automation Engine supercharges your Amazon Ad performance using conditional automation™ including signals like Buy Box winner, price, daypart and even weather.