PRODUCT
Follow

Error Response Structure

If, for any reason, a request fails, the Amazon Ad Server (AAS) API will respond with a standard internal server error (500) response. The following example shows the structure for a typical error response.

{ 
  "metadata": null, 
  "debug": null, 
  "error": [{
     "type": "APIErrorCollection", 
     "id": 1073917873, 
     "errors": [{
       "code": 41002, 
       "innerMessage": "Ad format mismatch",
       "propertyPath": null, 
       "value": null, 
       "entity": null, 
       "params": null 
     }] 
  }], 
"result": []
}

Error Codes

The following tables describe some of the error codes and messages, with affected fields, that AAS APIs return.

Trafficking Error Codes

Error Code

Description

1000000

The placement cannot be deleted. It has {id} delivery groups attached.

100001

The placement is not attached to the ad or the ad is disabled. 1001 Failed to retrieve entity.

1002

The CampaignTargetAudience entity does not exist.

1003

Null value in back-end server returned 'null' value.

11003

The video auto-transcoding process failed.

200003

Your session has timed out. Please log in to the platform again to access this page.

30006

The placement package cannot be deleted because it is connected to one or more placements.

31011

The placement package is not placement level. It cannot be modified.

31015

The placement package is not placement level. It cannot be modified.

31020

The placement cannot be deleted. It is attached to a delivery group.

31114

MediaCost must be empty in a verification tracking placement.

31154

Master ad {id} to replace was not found in the placement.

31155

The package can not be changed when placement status is published live or idle.

35000

Cannot generate tag. The placement is not enabled for serving.

35002

Tag generation failed for placement {id}. The placement can only be attached to a single untargeted delivery group.

35004

The published placement {id} cannot be detached.

35016

External media plan validation error ID {id} already exists.

35103

Placement could not be deleted. The placement is already published.

41002

Ad format mismatch.

41016

Failed to retrieve all master ads.

41017

Failed to replace all requested ads in the delivery group.

41019

Ad container on the same level must have the same rotation type.

41021

Could not attach the placements and ad due to dimension mismatch.

41022

A placement must be attached to at least one enabled ad.

41023

At least one ad must be enabled in the delivery group.

41024

Failed to detach placement from delivery group. A placement must include at least one untargeted delivery group.

41025

The target audience cannot be changed because the delivery group is published.

41026

The delivery group was not deleted because there are published placements related to the delivery group.

41028

Cannot detach from delivery group {id} because it is published.

41029

Placement {id} does not exist in any of the delivery groups received.

41030

Failed to detach published or live placements from an untargeted delivery group {id}.

41031

Cannot detach published or live placement {id} from an untargeted delivery group {id}.

41032

Cannot disable master ad from published delivery group {id} because it is the last enabled ad.

41033

Cannot disable a master ad from a published placement because it is the last enabled ad.

429

Too many requests

60000

MediaPrep General Error {0} - {1}

60001

Validation failed due to invalid '{0}' value.

60002

Validation failed due to illegal property 'brandId' update post creation.

60007

Try to save or update the contact(s) under site service.

60008

The Site ID in URL cannot be null or empty.

60012

Validation failed. The default contact contactId and role are not unique.

60013

Account must be one of the entity's creative management accounts.

60018

The site section could not be saved as the {0} site section name is not unique.

60020

A single template can be assigned to a Site or SiteSection.

60101

User validation failed. User 'userName' already exists.

60201

One or more of the contacts cannot have the selected role type.

60206

Assign the Billing Contact role to at least one contact in the Campaign Management contact list.

60209

Site contacts cannot be updated in the Brand entity.

60212

Contact {0} does not exist in the {1} site.

60405

Failed to remove the Creative Management type from the account because it exists in the campaign.

60406

The Campaign Management account must be set as a paying account.

60407

Failed to save entity. The attached account should be a Campaign Management account.

60408

Invalid Market ID.

61003

Delete operation failed.

61010

Failed to save entity. Ad Event with these parameters already exists.

61012

Failed to save entity. Please select ad formats that match all of the placement types selected.

61013

Delete operation failed.

61014

Failed to save entity. Custom serving rule with this parameters already exists.

61024

Variable with key {0} has a value ({1}) that is not of type {2}.

7000

Cannot add permission set under role type {0}. The item already exists.

7001

User does not have {0} permission and/or required role type to perform this action.

70010

You must be a platform user to complete this operation.

7002

User {0} does not have UI permission set.

7003

User {0} has multiple UI permission sets.

7004

The following permissions do not exist {0}.

7005

The following permission sets do not exist {0}.

7006

User {0} is not assigned role types.

7007

You must be a platform user to perform this action.

7008

User does not have {0} permission zone(s) to complete this action.

7009

Permission {0} cannot be granted on the user level.

7010

User does not have permission or has invalid permissions sets.

7011

Inconsistent user IDs on PermissionSettings object.

7012

Missing user IDs on user permissions sets for PermissionSettings object.

7013

Entity cannot be saved due to illegal parameter {0}.

7014

Missing at least one or more {0} property value(s).

7015

The {0} permission set cannot have more than a single hierarchy level of other permission sets.

7016

Illegal change of inner permission sets {0}.

7017

User {0} has invalid user permission settings due to missing or duplicate settings.

7018

Do not have permission to grant permissions due to invalid admin zone.

7019

Error while comparing permitted admin zones to user granted admin zones.

7020

User permission settings are missing the permission set {0} for permission {1}.

7021

The permission set {0} is attached as an inner permission set. Cannot add more than a single hierarchy level.

7022

Permission {0} cannot be granted to non-platform users.

80004

Your strategy could not be saved. Please try to refresh your strategy and then try saving again.

80006

This strategy cannot be deleted because it includes target audiences that are assigned to published placements.

80009

One or more of the branches you are removing cannot be deleted because they are assigned to a published target audience.

80010

This version of the strategy does not match the version in the database.

82000

Cannot remove tag manager because it includes firing conditions.

82001

Cannot remove a default tag manager.

82002

Specified account does not exist.

82003

Specified advertiser does not exist.

82004

Cannot remove advertiser because it includes firing conditions.

82005

Tag manager ID does not exist. 82006 Specified firing condition does not exist.

82007

Selected firing conditions are not from the same advertiser.

82008

Specified firing condition advertiser is not an advertiser in Tag Manager.

82009

Duration range not defined.

82010

Invalid range for date duration.

82011

Invalid expiration GMT value.

82012

Firing condition includes additional URLs.

82013

Firing condition includes additional tags.

82014

Firing condition does not include a tag.

82014

There is not tag for the firing condition.

82015

No value for the duration in the firing condition.

82016

No value for the start date or expiration date in the firing condition.

82017

No value for the start date in the firing condition.

82018

No value for the expiration date in the firing condition.

82019

No value for the duration gmt in the firing condition.

82020

Firing condition does not include a tag manager ID.

82021

Firing condition does not include a tag ID.

82022

Firing condition contains empty conditions.

82023

Firing condition contains an empty URL list.

82024

Condition occurrence does not match.

82025

Firing condition can only run one tag.

82026

Cannot remove a default firing condition.

82027

There is already a default tag manager for the selected advertiser.

82028

Invalid conditional parameter range values. Values must be integers and the From value must be less than the To value.

82029

Cannot change the conditional parameters for the default firing condition.

82030

Cannot update a default firing condition. 83100 Specified advertiser tag does not exist.

83100

Specified AdvertiserTag does not exists.

83101

Specified conversion tag does not exist.

83102

Specified tag type does not exist.

83103

Advertiser ID {1} cannot be updated.

83104

Account ID {1} cannot be updated.

83105

Failed to retrieve all tag managers \ %s\ .

83106

Failed to retrieve all conversion tags \ %s\ .

83107

Failed to retrieve all firing conditions \ %s\ .

83108

Failed to query retargeting tags \ %s\ .

83109

Please define only one tag to be fired.

83110

There is already a firing condition for the selected advertiser.

83111

Failed to retrieve query tag groups \ %s\ .

83112

Conversion tag ID does not exist.

83113

Cannot delete advertiser tag because it includes firing conditions.

83114

Conversion tag must match.

83115

Cannot update code for the specified tag.

9002

{string} field is null or empty.

9003

Error transforming API model to Data Model.

9004

Empty UI request. No entities to save or update.

9005

Property {id} cannot be null where {string} is the property path

9007

Property {id} cannot be null or empty.

9008

Property {id} length is invalid.

9009

The {string} URL Property Marker has an invalid URL format.

9010

The \ ID\ property must be null when saving a new entity.

9011

Maximum {number} property length limit exceeded.

9013

The email property is not a valid email.

9015

{id} {name} already exists. Please enter another {name} name.

9017

Property %s must be greater or equal to 1.

9018

URL exceeds the maximum length of 1000 characters.

9050

Query parameter {name} is invalid. Cannot be {}.

9123

Account does not exist or you have insufficient privileges.

9125

The {id} request was not returned from the repository. Request {id}.

9128

Error occurred while saving user.

9130

Failed to save AdvertiserBL.save entities.

9131

There is a problem with the name.

9132

Failed to retrieve entities.

9138

You must be a platform user to perform this action.

9140

The user does not have sufficient privileges to complete this action.

9141

Invalid user permissions due to missing or duplicate settings.

9142

End date should be later than start date.

9199

API search not used correctly

9200

The firstBillingCampaignManagerContact property must be null.

9201

Text in search contains an illegal value.

9990

An error occurred when transforming the backend response to the API response.

9995

A timeout exception occurred.

9998

General Error

9999

1. Oops! We’re sorry something went wrong…This service seems to be down at the moment. Please try again later.

or

2. Your token is expired or invalid. Please logout and login again.

99998

Failed to read site content.

Creative Error Codes

Error Code

Description

50001

Failed to save ads {id} - {id}.

50002

Failed to retrieve ads {id} - {id}.

50003

Failed to retrieve ads {id} - {id}.

50004

Failed to retrieve all ads - {id}.

50005

Failed to retrieve all ads in campaign ID {id}.

50006

Failed to retrieve all ads in account ID {id}.

50007

Failed to delete ad {id}.

50008

Failed to update ads {id} - {id}.

50009

Failed to copy ads {id} - {id}.

50010

Failed to assign master ads {id} to {id} - {id}.

50011

Failed to unassign master ads {id} - {id}.

50012

Failed to attach master ad {id} to placements {id} - {id}.

50013

Failed to retrieve placement ads for master ad {id}.

50014

Failed to retrieve placement ads according to placement ID {id}.

50015

Failed to retrieve and change status {id} of placement ads attached to master ad {id}.

50016

Failed to retrieve Account with ads in campaign ID {0} and account ID {1}.

50017

Failed to save master ads {id} - {id}.

50018

Failed to calculate ad size for ad {id}.

50019

Master ad ID {id} with placement ID {id} does not have placement ads - {id}.

50020

Failed to assign master ads to campaign {0} - {1}.

50021

Failed to unassign master ads from campaign {0} - {1}.

50022

Failed to merge custom interactions between request and database.

50023

Failed to determine if the ad could be updated.

50024

Failed to detach master ad {0} from placements {1} - {2}.

50025

Failed to update asset.

50026

Failed to delete asset.

50027

Failed to validate ad.

50028

Failed to save ad QA requests: {0} - {1}.

50029

Failed to delete ad QA request: {0}.

50030

Failed to update ad QA request: {0} - {1}

50031

The asset video auto-transcoding job failed.

50032

Failed to determine the number of placement ads attached to the master ad ID {0}.

50033

The assigned entity type should be either an Account Advertiser Campaign or Brand.

50034

Failed to change ad assignment. Ad {id} has placement ads.

50035

Failed to change ad assignment. Ad {id} name used in campaign.

50036

Failed to change ad assignment. Ad {id} does not exist.

50037

Failed to change ad assignment. Ad {id} name.

50038

No placement ads of the master ad ID {id} in placement ID {id} was found.

50039

Failed to change ad assignment. Ad {id} is already {string}.

50040

Failed to publish ad. Ad %s does not exist.

50041

Failed to publish ad. Master ad {id} cannot by published.

50042

Failed to publish ad. Ad {id} not attached.

50043

Failed to {0} ad. Ad {1} does not exist.

50044

Failed to calculate ad dimensions for ad {0} {1}.

50045

Failed to generate the default panel using asset for ad {0} - {1}.

50046

Failed to encode tag for ad {0}.

50047

Failed to find the main HTML file in the Workspace.

50048

Failed to create test page.

50050

Ads {0} not found.

50051

Campaigns {0} not found.

50052

Accounts {0} not found.

50053

Assets {0} not found.

50054

Placements {0} not found.

50055

Failed to determine Orch Type. Missing Orch Types Enum value for {0}.

50056

PrimaryCreativeAgency(s) {0} not found.

50057

AssetFolders {0} not found.

50075

Failed to determine Orch Type. Missing Orch Types Enum value for {0}.

50076

Ad QA requests {0} not found.

50077

Ad formats {0} not found.

50084

Failed to duplicate ad: {0}.

50085

Duplicating placement ad {0} is not allowed.

50086

Ad {0} does not contain asset {1}.

50087

Ad templates {0} not found.

50088

No ad templates were found.

50090

Failed to change the ad assignment. Ad {0} is attached to a delivery group {1}.

51001

Missing ad name.

51018

The panel name is not unique {0}.

51019

The additional asset name is not unique {0}.

51020

The additional asset is a duplicate {0}.

51021

Placement ID is missing.

51022

Additional asset size exceeds the limit of {0}. Please replace the asset.

51023

The ad size  exceeds the size limit. Please consider removing some assets from ad.

51024

Null value in {string}.

51025

Panel size exceeds the limit of {0}. Please replace it.

51026

The default image size exceeds the limit of {id}. Please replace it.

51027

The Preload banner size exceeds the limit of {id}. Please replace it.

51028

The Rich Media banner size exceeds the limit of {id}. Please replace it.

51029

The HTML5 Workspace size exceeds the limit of {id}. Please replace it.

51030

Panel file type {id} not allowed. Please replace it.

51031

Additional asset file type {id} not allowed. Please replace it.

51032

Default image file type {id} not allowed. Please replace it.

51033

Preload banner file type {id} not allowed. Please replace it.

51034

The HTML5 Workspace file type {id} not allowed. Please replace it.

51035

The Rich Media banner file type {id} not allowed. Please replace it.

51036

Property {id} cannot be changed in the {string} operation.

51037

Update is denied. Select only ads with the same format type.

51038

Update is denied. Selected ads include both master and placement ads.

51039

The panel name exceeds the limit of {0} characters.

51040

The additional asset name exceeds the limit of {0} characters.

51041

Ad {0} is not applicable to placement {1}.

51042

The AdFormat field does not match the Ad Entity type.

51043

The tooltip is limited to 250 characters.

51044

The number of panels exceeds the limit. Please remove some panels.

51045

The number of custom interactions exceeds the limit. Please remove some custom interactions.

51047

The name {name} is already used in ad ({id}).

51048

The '{name}' name is used in Campaign (Ad {id}).

51049

You cannot edit the placement ad name.

51050

{0}

51051

Assets must be set as linears or non-linears.

51052

You cannot change the placement ID for ad {id}.

51053

You cannot modify the data for ad {id}.

51054

The placement ID property must be null for master ad - ad {id}.

51055

The {id} placement ad must contain a placement ID.

51056

Cannot change the master ad ID for placement ad - ad {id}.

51057

Cannot change the ad format for ad {id}.

51058

Failed to delete ad {id}. Only master ads can be deleted.

51059

Failed to delete ad {id}. Ad is attached to a placement.

51060

Failed to delete ad {id}. Tracking pixel ads cannot be deleted.

51061

Changing the status for ad {0} is denied.

51062

Failed to {0} ad. MasterAd cannot be {1}.

51063

Failed to delete ad due to impressions {0} - ({1} impressions).

51064

The 1st party ad ID cannot be null or empty when generate multiple tags is false - placement ID {0}.

51065

The placement {0} contains duplicate 1st party ad IDs.

51066

The 1st party ad ID token cannot be null or empty when generate multiple tags is false - placement ID {0}.

51067

The linears do not contain actual linear objects.

51068

AS3 is required when creating Flash ads.

51069

The In-Stream ad contains an incorrect asset type.

51070

The In-Stream Interactive linears contain too many HTML5 assets.

51071

The linear exceeds the size limit of {0}. Please replace it.

51073

The non-linear size exceeds the size limit of {0}. Please replace it.

51074

The companion size exceeds the limit of {0}. Please replace it.

51075

The name '{0}' is already used in this Save Request (Ad {1}).

51076

Linear duration setting should be an integer.

51077

Linear duration setting should be greater than 0.

51078

Ad {0} cannot be deleted. It is currently assigned to multiple delivery groups {1}.

51079

An incorrect asset type has been assigned to your In-Stream companion.

51080

An incorrect asset type has been assigned to your In-Stream non-linears.

51081

In-Stream ads can have only one event of the type {0}.

51082

Additional Asset Name cannot be null or empty.

51083

Creation date or Creator ID cannot not be changed.

51084

Advanced Companion of type {0} is not a supported format (Ad ID {1}).

51085

Advanced Companion {0} does not exist.

51092

You cannot change the site ID for ad {0}.

52001

User not permitted to perform action.

52002

User not permitted to perform {0} on entity {1} with ID {2}.

52003

Failed to apply data ownership to {0} with ID {1}.

53001

Failed to create AdConfig for ad {0} - {1}.

53002

Failed to update AdConfig for ad {0}.

53003

Failed to save AdConfig for ad {0}.

53004

Failed to delete AdConfig for ad {0}.

53005

Failed to retrieve AdConfig for ad {0}.

53006

Failed to find an In-Stream template for {0}.

53007

Failed to retrieve VAST variables for XSLT file.

53008

Failed to retrieve the following In-Stream template parameters {0}.

53009

Failed to save the In-Stream template due to unsupported characters.

53050

AdConfig {0} not found.

54001

{0} custom interactions were added and {0} were deleted because custom interactions are included in assets.

54002

Asset video auto-transcoding failed due to {0}.

54003

Asset video auto-transcoding failed for ad {0} due to {1}.

55001

The default panel cannot be set by the user.

55002

Failed to run specific format logic for ad {0} - {1}.

55003

You can only set a single default panel for the ad.

55004

A default panel was not set.

55005

Asset {0} is cannot be used in more than one panel.

55006

The format name is already being used. Please enter a new format name.

55007

Name {0} is already in use by custom ad format{1}. Please use a different name.

55008

Ad format data is missing from the ad.

55009

Custom ad format id %s does not exist.

55010

Failed to run custom ad format validation for ad {0} - {1}.

55011

Ad format id {0} does not belong to the specified base ad format {1}.

55012

Changing enhanced option from {0} to {1} for ad %s is not allowed.

55013

The Enhanced In-Stream ad format does not support an SWF asset with interactions. Please use the In-Stream interactive ad format.

55014

Failed to validate custom ad format.

55015

Base ad format cannot be changed.

55016

Format name cannot be changed.

55017

Formats that are available to all platform accounts cannot be selected for specific accounts.

55018

Failed to apply data ownership.

55019

The number of scripts exceeds the maximum limit of 5. Please remove some scripts.

55020

Failed to run custom ad format logic for ad {0} - {1}.

55021

Variable with key {0} is defined more than once.

55022

Only the default value for a variable can be changed.

55023

Variable key {0} is not compliant with JavaScript requirements.

55024

Variable with key {0} has a default value ({1}) that is not of type {2}.

55025

Variable with key {0} default value cannot be empty when the mandatory property is set to 'true'.

55026

The Mandatory Field parameter for Variable key {0} is selected therefore the Show in Ad UI parameter must also be selected.

55027

Please enter a default value for Variable Key {0}.

55028

'id' is not in the custom ad format range.

55029

Custom ad format with id {0} already exists.

55030

The In-Stream template ID {0} does not exist.

55031

A Standard Banner ad cannot include video assets. Please remove the asset and update the Workspace or select a different format.

55032

The ad {0} can not be attached because it is not assigned to a campaign.

55033

Ad {0} must have panel settings.

55034

Ad {0} must have a workspace defined to support polite loading.

55035

Ad {0} must have an initial asset selected in order to support polite loading.

55036

Ad {0} must have Download mode selected in order to support instant/polite loading

55037

Cannot save or update ad {0} for this Verification Tracking Ad type.

55038

Event {0} cannot be defined more than once.

55039

Event {0} cannot be defined for this ad format.

55040

Ad template with ID %s already exists.

55041

Templates marked as available to all accounts cannot have assigned accounts.

55042

Failed to validate this ad template.

55043

Number of applicable authoring tools cannot be 0. Please add at least one.

55044

The internal ad data ID does not match the template ID.

55045

The user-defined ID is supported only for migrated custom ad formats.

55046

Accounts Availability and Applicable Accounts mismatch.

55047

Accounts Availability does not support this option.

55048

The provided ad format and the ad format set in the Manifest file do not match.

55049

Safety check failure.

55050

Asset {0} cannot be deleted since it is being used by ad {1}.

55051

Workspace {0} cannot be deleted since it is being used by ad {1}.

55053

Asset {0} is not part of the HTML5 workspace used in this ad.

56001

Failed to save custom ad format {0} - {1}.

56002

Failed to retrieve all custom ad formats - {0}.

56003

Failed to update custom ad format {0} - {1}.

56004

Failed to delete custom ad format {0}.

56006

HTML5 folder {0} not contain the index.html file.

56007

Failed to initialize ad events combinations.

56008

Ad event {0} exceeds instance count limit of {1}.

56009

Ad event {0} was not passed to the placement ad because it does not meet the include/exclude site condition.

56010

Failed to publish detach message for placement {0}.

56011

Failed to publish ad {0}.

56014

Failed to get ad template {0}.

56015

Failed to get all ad templates - {0}.

56016

Failed to get ad templates {0} - {1}.

56017

Failed to save ad template {0} - {1}.

56018

Failed to update ad template {0} - {1}.

56020

Failed to get the templates assets folder.

56021

Failed to create a folder for the template assets.

56023

Failed to propagate Manifest file data into the ad.

56024

Failed to find the Manifest file in the selected Workspace.

56025

Failed to propagate basic ad properties configured in the Manifest file.

56026

Failed to propagate polite loading ad properties configured in the Manifest file.

56027

Failed to propagate panels settings configured in the Manifest file.

56028

Failed to propagate custom interactions configured in the Manifest File.

56029

Failed to propagate default image configured in the Manifest File.

56030

No ads were found that meet the search criteria.

56031

Failed to get ads by asset IDs {0}.

56032

Failed to get ads by workspace IDs {0}.

Reporting Error Codes

Error Code 100

Information was not provided for the entity.

<FIELD> is either empty or does not exist.

This error code applies to the following fields:

  • accounts

  • reportStartDate

  • reportEndDate

  • timeZone

  • dateResolution

  • fileType

Error Code 101

Invalid value was provided for [element].

Invalid value for <FIELD>:<VALUE>

This error code applies to the following fields: (Example: "accounts": "2320gfg4")

  • accounts

  • advertisers

  • campaigns

  • sites

  • reportStartDate

  • reportEndDate

Error Code 102

You can use only one entity group in addition to the account (advertisers/campaigns/sites).

Error Code 103

Invalid value for time/date. The value must be 10 digits in this format: yyyyMMddHH.

Error Code 104

reportStartDate is greater than reportEndDate.

Error Code 105

Invalid value for <FIELD&>: <VALUE>

The value must be one of the following: <LIST OF ACCEPTABLE VALUES>

Affected Fields

Acceptable Values

reportStartDate

Value must be 10 digits (yyyyMMddHH).

reportEndDate

Value must be 10 digits (yyyyMMddHH).

timeZone

[us/eastern], [us/central].

dateResolution

[hour], [day], [week], [month], [year].

fileType

[csv], [txt].

Error Code 200

Internal error during validation.

Error Code 201

Metric is not compatible with attribute.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments