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.

<response>
 <status>
  <code>-2</code>
  <error>Access denied</error>
 </status>
</response>

With additional information about the incorrect parameter.

<response>
 <status>
  <code>-6</code>
  <error>Incorrect value</error>
  <parameter>encoding</parameter>
  <value>123</value>
 </status>
</response>

A request may be partially executed. In this case, the response contains the <code>0</code> tag and the message tag describing the part of the request that hasn't been executed.

See the error code key in the table:

Error code	Error	Key
-1	Authorization failed	Authorization error. Check that 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	Insufficient permissions to access the object.
-2	Change targeting by URL is not allowed	Insufficient permissions to edit targeting by URL.
-3	Invalid object name	Invalid object. Check the context name.
-4	Invalid action object name	Invalid actionObject. Check the name of the object in question.
-5	Invalid action name	Invalid action. Check the action name.
-6	Incorrect value	Invalid parameter value. Check the parameter value.
-6	Type 3 is not allowed	Invalid URL template type in the `templateType` parameter.
-6	Maximum allowed referrers 5	Too many template lines in `targetingUrlOn` or `targetingUrlOff`. A maximum of 5 lines is allowed.
-6	Value for 'placeId' is required	The `placeID`, `siteID`, or `zoneID` parameter is 0 or undefined.
-7	Value required	Missing a required parameter. Check that the request contains all required parameters.
-8	Account already exists	This 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	A warning when you enable or disable a placement:
-10	This object is placed upper	The object is enabled in the placement at a higher level.
-10	This object is unplaced upper	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 value of the parameter exceeds the line limit.
-14	Duplicate entry	The ID of the value of an additional characteristic or an action tracking point is already used. Enter 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 `<parameter>` tag and the parameter value to the `<value>` tag. The response will also contain the maximum and minimum values.
-16	Type required	The required `type` parameter isn't specified for the banner placement setting. Add the “type” parameter that determines the placement logic (on the site or in the ad network).
-99	Multiple errors	When adding a backup ad for a banner type or placement, no value was specified for the image URL (defaultImageURL) or click URL (defaultHitURL) parameter.
-100		The file is too large.
-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	Too many authorization attempts (seven incorrect attempts in the last five minutes). You need to check the authorization data and try again after 10 minutes.
-680	Connection limit reached	Too many concurrent requests. 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 clicks.
-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 clicks.
-1500	Only marked as “For insertion code with context.js” banners can be added in campaign with Impression method “Viewable impression, 2 seconds”.	If your campaign uses “Viewable impressions, 2 seconds” as the impression count method, you can only add banners with templates that have the [context] tag in their name.
-1501	Banners do not match the campaign, or they are deleted	Copied banners are missing from the specified campaign or have been 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 your campaign uses “Viewable impressions, 2 seconds” as the impression count method, you can only copy banners with templates that have the [context] tag in their name.
-1504	Campaign kind is not dynamic allocation	Can't set a 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 on this 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	To change the CPM, you need to wait 5 minutes. Please wait 5 minutes.	Repeat the request to change the CPM in five minutes.
-1508	Incorrect JSON format in “blocks” field	The JSON value is described incorrectly, or there's no “blocks” parameter in the logical targeting. Check the syntax and repeat the request.
-1516	Can not copy campaigns or banners with external monetization	Campaigns and banners created for external monetization platforms (criteo, Soloway, myTarget, and others) can't be copied. Copying banners from ad campaigns for monetizers is also prohibited.
-2000	Advertiser is not assigned for current assistant	The assistant can't work with this advertiser. Change the assistant's permissions 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 need 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 can only contain numbers, Latin letters, and underscores. 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	This archive type is not supported. You can only use a ZIP archive.
-10106	Must be one html file in archive	The archive 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 wasn't transmitted, or no data could be obtained from the transmitted parameters (for example, you specified template creatives with no data).
-20001	The advertising campaign is not marked	Can't enable labeling for the banner, since it is disabled for the advertising campaign.
-20002	The contract not found	Couldn't find the contract.
-20003	The customer not found	Couldn't find the client.
-20004	The executor not found	Couldn't find the contractor.
-20005	The intermediary contract not found	Couldn't find the parent contract.
-20006	The customer and the executor cannot be the same contractor	The client and the contractor can't be the same counterparty.
-20007	Intermediary contract id can not be empty	The parent contract ID must be specified for this contract.
-20008	The contract can not be deleted because it is linked to a campaign	Can't delete the contract because it is linked to a campaign.
-20009	The contract can not be deleted because it is linked to a supercampaign	Can't delete the contract because it is linked to a supercampaign.
-20010	The contract can not 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	Can not delete role “Executor”. There are sites associated with this executor	The “Contractor” role can't be deleted. There are sites associated with this contractor.
-20012	Can not delete role “Executor”. There are contracts associated with this executor	The “Contractor” role can't be deleted. There are contracts associated with this contractor.
-20013	Can not delete role “Customer”. There are contracts associated with this customer	The client role can't be deleted. There are contracts associated with this contractor.
-20014	The contractor can not be deleted because it is linked to a contracts	You can't delete a contractor with valid contracts.
-20015	The contractor can not be deleted because it is linked to a sites	You can't 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.

Was the article helpful?

modify

Change history