--- metadata: - name: generator content: Diplodoc Platform v5.50.1 alternate: - https://yandex.com/dev/adfox/doc/en/v.1/errors.md - https://yandex.com/dev/adfox/doc/ru/v.1/errors.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/adfox/doc/en/llms.txt # Error handling If there's an `error` tag in the response, it means an error occurred when processing the request. You need to correct the request and repeat it. Sample error response: - As a simple structure. ```xml -2 Access denied ``` - With additional information about the incorrect parameter: ```xml -6 Incorrect value encoding 123 ``` A request may be _partially executed_: in this case, the response contains the `0` tag and the `message` tag describing the part of the request that hasn't been executed. See the error code key in the table: #| || **Code** | **Error** | **Key** || || -1 | Authorization failed | Authorization error. Check whether the login and password are correct. The password must be passed as the value of the SHA256 hash function from the user's password. || || -2 | Access denied | Access to the object is denied. You don't have enough access rights. || || -2 | Change targeting by URL is not allowed | You don't have access to editing targeting by URL. || || -3 | Invalid object name | Incorrect object. Check the context name. || || -4 | Invalid action object name | Incorrect actionObject. Check the name of the object that the action is performed on. || || -5 | Invalid action name | Incorrect action. Check the action name. || || -6 | Incorrect value | Incorrect parameter value. Check the parameter value. || || -6 | Type 3 is not allowed | An invalid URL template type is set for the `templateType` parameter. || || -6 | Maximum allowed referrers 5 | Exceeded the number of template lines for `targetingUrlOn` or `targetingUrlOff`. A maximum of 5 lines is allowed. || || -6 | Value for 'placeId' is required | The `placeID`, `siteID` or `zoneID` parameter isn't specified or is equal to 0. || || -7 | Value required | A required parameter isn't set. Check whether the request contains all required parameters. || || -8 | Account already exists | The account already exists (the error is displayed when you create or rename an account). Try entering a different account name. || || -9 | Value must be not NULL | The parameter can't be empty. Specify the parameter value. || || -10 | This object is placed upper | A warning when you enable or disable a placement: the object is enabled in the placement at a higher level. || || -10 | This object is unplaced upper | A warning when you enable or disable a placement: the object is disabled in the placement at a lower level. || || -11 | Error file uploading | File upload error. Incorrect links to media data transmitted. The tag will contain the URL that the data could not be uploaded for. || || -12 | Value is out of length | The maximum allowed length of the parameter value line has been exceeded. || || -14 | Duplicate entry | This identifier of the value of an additional characteristic or an action point is already in use. Specify a different value for the `userID` parameter. || || -15 | Invalid type | Invalid data type: - When the object passed is different from an array (for example, a string for OKVED codes instead of an array). - Invalid JSON for media data. The parameter name is added to the `` tag and the parameter value to the `` tag. The response will also contain the maximum and minimum values. || || -16 | Type required | Missing the required `type` parameter for the [banner placement setting](https://yandex.com/dev/adfox/doc/en/v.1/banner/banner-modify-placement.md). Add the `type` parameter that determines the placement logic (on a site or in an ad network). || || -99 | Multiple errors | When adding a backup ad for a [banner type](https://yandex.com/dev/adfox/doc/en/v.1/bannerType/bannerType-updateDefaultBanner.md) or [placement](https://yandex.com/dev/adfox/doc/en/v.1/place/place-updateDefaultBanner.md), no value was specified for the **image URL** (`defaultImageURL`) or **click-through URL** (`defaultHitURL`) parameter. || || -100 | | The maximum allowed file size has been exceeded. || || -101 | | Incorrect MIME type. || || -102 | | Internal error. || || -103 | | Internal error. || || -200 | | Couldn't load the file at the specified URL. || || -667 | Logon errors limit reached | The limit of authorization errors has been reached: 7 incorrect attempts were made in the last 5 minutes. You need to check the authorization data and try again after 10 minutes. || || -680 | Connection limit reached. | The maximum number of concurrent requests was exceeded. Repeat the request later. || || -999 | Http is not allowed | This type of request can't be executed over the HTTP protocol. Repeat the request over HTTPS. || || -1415 | Daily amount of views should be set. | Set the daily number of impressions. || || -1416 | Daily amount of clicks should be set. | Set the daily number of click-throughs. || || -1420 | Cumulative amount of views should be set. | Set the total number of impressions. || || -1420 | Cumulative amount of clicks should be set. | Set the total number of click-throughs. || || -1500 | Only marked as "For insertion code with context.js" banners can be added in campaign with Impression method "Viewable impression, 2 seconds" | If a campaign uses [Viewable impression, 2 seconds](https://yandex.com/dev/adfox/doc/en/v.1/account/account-add-campaign.md#add-campaign-impressionMethodID) as the impression count method, only banners with [templates that have the [context] tag in their name](https://yandex.com/dev/adfox/doc/en/v.1/bannerType/bannerType-list-template.md) can be added to the campaign. || || -1501 | Banners do not match the campaign, or they are deleted. | Banners required for copying weren't found in the specified campaign, or they were deleted. Check the values for the `objectID` and `listIDs` parameters. || || -1502 | Only banners with templates marked as "For insertion code with context.js" is allowed to add in this campaign. | If a campaign uses [Viewable impression, 2 seconds](https://yandex.com/dev/adfox/doc/en/v.1/account/account-add-campaign.md#add-campaign-impressionMethodID) as the impression count method, only banners with [templates that have the [context] tag in their name](https://yandex.com/dev/adfox/doc/en/v.1/bannerType/bannerType-list-template.md) can be copied to the campaign. || || -1504 | Campaign kind is not dynamic allocation. | Can't determine CPM because the ad campaign type isn't **Dynamic monetization**. Change the campaign type and repeat the CPM change. || || -1505 | Dynamic allocation is not enabled. | The **Dynamic monetization** module isn't enabled in the account. Contact support to enable the module. || || -1506 | CPM is blocked in system campaigns. | Can't change the CPM for a system ad campaign. Check the ID of the campaign that you want to edit. || || -1507 | CPM is required | Specify CPM. || || -1508 | CPC is required | Specify CPC. || || -1509 | CPV is required | Specify CPV. || || -1510 | CPM is not allowed | You can't use a CPM. || || -1511 | Request contains too many "cost per" fields (CPM/CPC/CPV) | The request contains too many **cost-per-unit** fields (CPM/CPC/CPV). || || -1512 | Target CPC is required | Specify a target CPC. || || -1513 | Minimum VTR is required | Specify a minimum VTR. || || -1514 | You cannot specify the minimum CTR with CPC | Can't specify a minimum CTR using a CPC. || || -1515 | You cannot specify the minimum CTR with CPV | Can't specify a minimum CTR using a CPV. || || -1516 | Can not copy campaigns or banners with external monetization | Campaigns and banners created for external monetizers (such as criteo, Soloway, mytarget, and others) can't be copied. Copying banners from ad campaigns for monetizers is also prohibited. || || -1523 | Too many "cost per" fields (CPM/CPC/CPV) greater then zero | The request contains multiple cost fields for an action. || || -1524 | You must specify at least one "cost per" field (CPM/CPC/CPV) | Set a value for at least one **cost-per-unit** field (CPM/CPC/CPV). || || -2000 | Advertiser is not assigned for current assistant. | The assistant can't work with this advertiser. [Change the assistant's permissions](https://yandex.ru/support/adfox-sites/users/assistant.html?lang=en#assistant__access-assistant) or create a campaign with an advertiser that's available to the assistant. || || -2500 | You should use IMS template in IMS campaign. | When you create a banner in a campaign with the IMS impression count method, you have to use IMS templates. Get a list of templates for the banner type and make sure that IMS is enabled in the template (`isIms`=`1`). || || -10101 | File size limit reached. | By default, the maximum file size is 300 KB. The maximum video size is 1 MB. || || -10103 | Wrong file type. | Invalid file type in the archive. Allowed file types: CSS, JS, HTML, GIF, PNG, JPG, JPEG, SVG, JSON, FLV, MP4, OGV, OGG, WEBM, AVI, SWF, OTF, TTF, ABF, ACFM, GDR, ETX, EOT, FNT, FON, MF, TTC, and WOFF. || || -10104 | Wrong file name. | File names must only contain numbers or Latin letters and an underscore character. You can't use Cyrillic letters, spaces, quotation marks, hyphens, and special characters in the file name. || || -10105 | Too long html field. | The HTML code can't be longer than 65,000 characters. || || -10105 | Unsupported archive type. | The archive type is unsupported. You can only use a ZIP archive. || || -10106 | Must be one html file in archive. | The project can contain only one file with the HTML extension. || || -10108 | Files depth limit reached. | The file nesting depth has been exceeded. The maximum nesting level is 2. || || -20000 | You need to specify the creative data. | Data about creatives was not transmitted or data could not be obtained from the transmitted parameters (for example, template creatives with no data are specified). || || -20001 | The advertising campaign is not marked. | Can't enable the ad register for the banner, since it is disabled for the advertising campaign. || || -20002 | The contract not found. | No contract was found. || || -20003 | The customer not found. | No customer was found. || || -20004 | The executor not found. | No contractor was found. || || -20005 | The intermediary contract not found. | No parent contract was found. || || -20006 | The customer and the executor cannot be the same contractor. | The customer and the contractor cannot be the same counterparty. || || -20007 | Intermediary contract ID cannot be empty. | The parent contract ID must be specified for this contract. || || -20008 | The contract cannot be deleted because it is linked to a campaign. | Can't delete the contract because it is linked to a campaign. || || -20009 | The contract cannot be deleted because it is linked to a supercampaign. | Can't delete the contract because it is linked to a supercampaign. || || -20010 | The contract cannot be deleted because it has an additional agreement associated with it. | Can't delete the contract because there is an additional agreement associated with it. || || -20011 | Cannot delete the "Executor" role. There are sites associated with this executor. | The “Executor” role cannot be deleted. There are sites associated with this contractor. || || -20012 | Cannot delete the "Executor" role. There are contracts associated with this executor. | The “Executor” role cannot be deleted. There are contracts associated with this contractor. || || -20013 | Cannot delete the "Customer" role. There are contracts associated with this customer. | The “Customer” role cannot be deleted. There are contracts associated with this contractor. || || -20014 | The contractor cannot be deleted because it is linked to contracts. | You cannot delete a contractor there are valid contracts with. || || -20015 | The contractor cannot be deleted because it is linked to sites. | You cannot delete the contractor. There are sites associated with them. || || -20040 | INN is duplicated | A contractor with this INN (Taxpayer ID) already exists. || || -20042 | Incorrect conclusion date (the date must be greater than 1991.01.01 and not older than the current date) | Invalid date of the contract or additional agreement. The date must be not earlier than 1991/01/01 and not later than the current date. || || -20050 | Token field is not allowed when sendToErir=1 | You can pass a third-party token only when data submission to the state register (ERIR) is disabled. If `sendToErir`=`1`, a custom token is generated in the creative. || || -20051 | Invalid third-party token (letters and numbers only allowed) | Invalid third-party token (only Latin letters and numbers are allowed). || || -20072 | AMOUNT_CANT_BE_EMPTY | The amount of a paid contract can't be zero. || || -20073 | AMOUNT_SHOULD_BE_EMPTY | The contract amount must be zero. || || -20074 | CANT_CHANGE_SOCIAL_TYPE | Can't change the type of social advertising because the contract has associated invoices. || || -20075 | CHARGE_PAID_BY_AGENT | The “Paid by the intermediary” attribute can only be set in an intermediary contract where the intermediary represents the advertiser. || || -20076 | HAS_INVOICE_REF_CANT_CHANGE_ROLE | Can't change the contract role (there are associated invoices). || || -20077 | HAS_CAMPAIGN_REF_CANT_CHANGE_ROLE | Can't change the contract role (there are associated campaigns). || || -20078 | Intermediary contract id must be empty in not additional agreement contracts | If the main contract is selected in a contract that isn't an additional agreement. || |#