Коды ошибок

Справочник ошибок и ответов API

При выполнении некорректного запроса к системе наше API может вернуть код ошибки, в случае же верного запроса, API вернёт ответ. Вы, конечно, уже обрабатывали ответ сервера в ходе отладки своих виджетов или написании скриптов, взаимодействующих с нашей системой. Для Вашего удобства, мы решили систематизировать все возможные ответы и ошибки, отдаваемые нашей системой и разместить их на отдельной странице. Надеемся это облегчит и ускорит интеграцию Ваших проектов с amoCRM.

Ответы при авторизации

Подробнее об авторизации читайте здесь

Код HTTP код Описание
110 401 Unauthorized Общая ошибка авторизации. Неправильный логин или пароль.
111 401 Unauthorized Возникает после нескольких неудачных попыток авторизации. В этом случае нужно авторизоваться в аккаунте через браузер, введя код капчи.
112 401 Unauthorized Возникает, когда пользователь выключен в настройках аккаунта "Пользователи и права" или не состоит в аккаунте.
113 403 Forbidden Доступ к данному аккаунту запрещён с Вашего IP адреса. Возникает, когда в настройках безопасности аккаунта включена фильтрация доступа к API по "белому списку IP адресов".
101 401 Unauthorized Возникает в случае запроса к несуществующему аккаунту (субдомену).
401 401 Unauthorized На сервере нет данных аккаунта. Нужно сделать запрос на другой сервер по переданному IP.

Ответы при работе с аккаунтом

Подробнее о работе с аккаунтом читайте здесь

Код Описание
101Аккаунт не найден
102POST-параметры должны передаваться в формате JSON
103Параметры не переданы
104Запрашиваемый метод API не найден

Ответы при работе с контактами

Подробнее о работе с контактами читайте здесь

Код Описание
201Добавление контактов: пустой массив
202Добавление контактов: нет прав
203Добавление контактов: системная ошибка при работе с дополнительными полями
204Добавление контактов: дополнительное поле не найдено
205Добавление контактов: контакт не создан
206Добавление/Обновление контактов: пустой запрос
207Добавление/Обновление контактов: неверный запрашиваемый метод
208Обновление контактов: пустой массив
209Обновление контактов: требуются параметры "id" и "updated_at"
210Обновление контактов: системная ошибка при работе с дополнительными полями
211Обновление контактов: дополнительное поле не найдено
212Обновление контактов: контакт не обновлён
219Список контактов: ошибка поиска, повторите запрос позднее

Ответы при работе со сделками

Подробнее о работе со сделками читайте здесь

Код Описание
213Добавление сделок: пустой массив
214Добавление/Обновление сделок: пустой запрос
215Добавление/Обновление сделок: неверный запрашиваемый метод
216Обновление сделок: пустой массив
217Обновление сделок: требуются параметры "id", "updated_at", "status_id", "name"'
240Добавление/Обновление сделок: неверный параметр "id" дополнительного поля

Ответы при работе с событиями

Подробнее о работе с событиями читайте здесь

Код Описание
218Добавление событий: пустой массив
221Список событий: требуется тип
226Добавление событий: элемент события данной сущности не найден
244Добавление событий: недостаточно прав для добавления события
222Добавление/Обновление событий: пустой запрос
223Добавление/Обновление событий: неверный запрашиваемый метод (GET вместо POST)
224Обновление событий: пустой массив
225Обновление событий: события не найдены

Ответы при работе с задачами

Подробнее о работе с задачами читайте здесь

Код Описание
227Добавление задач: пустой массив
228Добавление/Обновление задач: пустой запрос
229Добавление/Обновление задач: неверный запрашиваемый метод
230Обновление задач: пустой массив
231Обновление задач: задачи не найдены
232Добавление событий: ID элемента или тип элемента пустые либо неккоректные
233Добавление событий: по данному ID элемента не найдены некоторые контакты
234Добавление событий: по данному ID элемента не найдены некоторые сделки
235Добавление задач: не указан тип элемента
236Добавление задач: по данному ID элемента не найдены некоторые контакты
237Добавление задач: по данному ID элемента не найдены некоторые сделки
238Добавление контактов: отсутствует значение для дополнительного поля
244Добавление сделок: нет прав.

Ответы при работе с каталогами

Подробнее о работе с каталогами читайте здесь

Код Описание
405Метод передачи запроса неверный
222Добавление/Обновление/Удаление каталогов: пустой запрос
244Добавление/Обновление/Удаление каталогов: нет прав.
281Каталог не удален: внутренняя ошибка
282Каталог не найден в аккаунте.
283Неверный запрос, данные не переданы.
284Неверный запрос, передан не массив.
285Требуемое поле не передано.

Ответы при работе с элементами каталога

Подробнее о работе с элементами каталога читайте здесь

Код Описание
405Метод передачи запроса неверный
203Добавление/Обновление элементов каталога: системная ошибка при работе с дополнительными полями
204Добавление/Обновление элементов каталога: дополнительное поле не найдено
222Добавление/Обновление/Удаление элементов каталога: пустой запрос
244Добавление/Обновление/Удаление элементов каталога: нет прав.
280Добавление элементов каталога: элемент создан.
282Элемент не найден в аккаунте.
283Неверный запрос, данные не переданы.
284Неверный запрос, передан не массив.
285Требуемое поле не передано.

Ответы при работе с покупателями

Подробнее о работе с покупателями читайте здесь

Код Описание
288Недостаточно прав. Доступ запрещен.
402Необходимо оплатить функционал
425Функционал недоступен
426Функционал выключен

Другие ответы

Ошибки и ответы, не относящиеся к какому-либо конкретному разделу

Код Описание Примечание
400Неверная структура массива передаваемых данных, либо не верные идентификаторы кастомных полей
402Подписка закончиласьВместе с этим ответом отдаётся HTTP код №402 "Payment Required"
403Аккаунт заблокирован, за неоднократное превышение количества запросов в секунду Вместе с этим ответом отдаётся HTTP код №403
429Превышено допустимое количество запросов в секундуВместе с этим ответом отдаётся HTTP код №429
2002По вашему запросу ничего не найденоВместе с этим ответом отдаётся HTTP код №204 "No Content"