401 Unauthorized в n8n: credentials, API keys и OAuth ¶

Обновлено: 2026-05-29

401 Unauthorized означает, что внешний сервис не принял авторизацию. Запрос дошёл до API, но credentials, token, header или scope не подходят. В отличие от 403, здесь чаще проблема именно в идентификации запроса.

Пошаговая проверка¶

1. Убедитесь, что в ноде выбраны правильные credentials.
2. Проверьте, не истёк ли OAuth token и есть ли refresh.
3. Сравните header авторизации с документацией API.
4. Проверьте scope/permissions приложения.
5. Повторите минимальный запрос в HTTP Request без лишнего body.

Bearer token¶

Для многих API header должен выглядеть так: Authorization: Bearer TOKEN. Частая ошибка — вставить только token туда, где нужен полный header, или наоборот продублировать слово Bearer.

Authorization: Bearer {{ $credentials.apiKey }}
Content-Type: application/json

OAuth-проблемы¶

Где искать ошибку в n8n¶

Откройте execution, проблемную ноду и вкладку с request/response. Нужны status code, response body и headers. Не копируйте секреты в публичные места: маскируйте token и ключи.

Связанные статьи¶

Для универсальной диагностики API смотрите HTTP Request. Для OpenAI — OpenAI, для Telegram — Telegram, для Google Sheets — Google Sheets.

Диагностика по шагам: как не лечить симптом вслепую

Проблему 401 Unauthorized в n8n: credentials, API keys и OAuth лучше разбирать как incident, а не как случайную ошибку в одной ноде. Сначала соберите доказательства, затем меняйте настройки workflow.

Проверка за 7 минут

1. Откройте последний failed execution и сравните его с последним successful execution того же workflow.
2. Зафиксируйте входной item: сколько items пришло, какие поля отсутствуют, есть ли binary data.
3. Проверьте credentials отдельно: токен, scopes, refresh, базовый URL, права пользователя.
4. Повторите запрос из HTTP Request через curl/Postman с теми же headers и body.
5. Посмотрите, не сработали ли rate limits, timeout, proxy, SSL или блокировка по IP.
6. Если ошибка плавающая, добавьте временный лог в безопасное хранилище: execution_id, event_id, status_code, краткое тело ответа.

Правильный порядок исправления

После фикса

• запустите старый failed payload повторно на тестовой копии workflow;
• проверьте, что ошибка не превратилась в silent failure;
• добавьте ссылку на эту страницу в error workflow или alert-сообщение;
• для повторяющихся инцидентов используйте workflow уведомлений об ошибках.

Глубокая диагностика: что проверить до изменения workflow ¶

Для проблемы 401 Unauthorized в n8n: credentials, API keys и OAuth сначала зафиксируйте факты, а не меняйте ноды наугад. Откройте failed execution, найдите первую ноду, где входные данные ещё корректны, а выход уже отличается от ожидаемого. Сравните не только текст ошибки, но и item count, полный JSON, headers, status code, binary data и время выполнения.

• Запишите слой сбоя: данные, авторизация, API, нода, очередь, база, reverse proxy или AI-слой.
• Соберите минимальный воспроизводимый пример на одном item и отдельно прогоните batch из 3–5 items.
• Проверьте, не маскирует ли retry исходную ошибку: в истории executions смотрите первый, а не последний сбой.
• Если задействован oauth, сравните реальный request/response из n8n с рабочим запросом вне n8n, скрыв секреты.
• После исправления сохраните пример плохого payload в тестовом workflow или в runbook, чтобы не терять контекст.

Решение без побочных эффектов ¶

Правка должна быть минимальной: исправляйте только тот слой, где доказана причина. Для 401 Unauthorized в n8n: credentials, API keys и OAuth опасно одновременно менять credentials, mapping, retry и бизнес-логику: после этого сложно понять, что действительно помогло.

Контрольный список после исправления ¶

• один успешный и один проблемный пример проходят предсказуемо
• в execution видно, какие данные ушли дальше по цепочке
• ошибка больше не скрывается за общим сообщением вроде “workflow failed”
• alert отправляется владельцу workflow с ID execution и короткой причиной
• для внешних записей есть ключ идемпотентности: order_id, event_id, email+date или payload_hash

{
  "execution_id": "exec_...",
  "workflow_id": "wf_...",
  "node_name": "node_with_symptom",
  "error_message": "точный текст ошибки без токенов",
  "input_item_id": "external_or_dedupe_id",
  "last_successful_run": "timestamp",
  "changed_before_error": ["credentials", "payload", "version", "env"]
}