# Налаштувати вебхук команди

Створює або замінює конфігурацію вебхука команди.
- **Передумови**: `callbackUrl` має бути HTTPS-URL довжиною від 1 до 1024 символів, з іменем хоста, без даних користувача, без фрагмента та з коректним портом. Усі адреси, у які він розв'язується, повинні маршрутизуватися в інтернеті; діапазони localhost, приватні, link-local, CGNAT, метаданих хмари, зарезервовані протоколом, документаційні та 6to4 відхиляються. Та сама перевірка повторюється в момент відкриття з'єднання під час доставки, тому імʼя, яке згодом розв'яжеться у приватний діапазон, призведе до невдачі цієї доставки, а не до звернення у вашу мережу.
- **Дія**: виконує upsert єдиної конфігурації команди із серверного контексту. `teamId` ніколи не читається із запиту, тому той, хто викликає, не може налаштувати іншу команду. Ендпоінти Local API та Open API читають і пишуть той самий запис, а відповідь повторює збережене.
- **Вимкнення**: `enabled: false` зберігає URL і припиняє створення нових подій. Уже поставлені в чергу події скасовуються по одній, якщо на момент їх авторизації конфігурація все ще вимкнена, тому швидке повторне ввімкнення дає їм продовжитися.
- **Повтор**: безпечно. Збереження — це upsert за командою, тому повторення того самого запиту сходиться до того самого стану.
- **Версія клієнта**: потрібен клієнт MoreLogin v2.66.0 або новіший, оскільки локально цей маршрут публікує саме настільний клієнт. Ендпоінт Open API від клієнта не залежить.

Контракт зворотного виклику, назви подій і розклад повторів див. у [Webhooks](../Getting%20Started/webhooks.md).
Задокументовані бізнес-помилки: `41001`. Значення кодів див. у [Error Codes](../Getting%20Started/error-codes.md). Будь-яка операція може додатково повернути загальні коди.

Endpoint: POST /api/webhook/config
Version: 2026-09-05

## Request fields (application/json):

  - `callbackUrl` (string, required)
    HTTPS-URL, який приймає події. Від 1 до 1024 символів.

  - `enabled` (boolean, required)
    Чи ввімкнено доставку для команди.

## Response 200:

  - `200` (unknown)
    Успіх. `data` — об'єкт із полями `callbackUrl` та `enabled`, що повторює збережену конфігурацію.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Код результату. `0` — успіх; інші коди означають помилку.

  - `msg` (string | null, required)
    Повідомлення про помилку

  - `data` (object, required)

  - `data.callbackUrl` (string)
    Збережений HTTPS-URL зворотного виклику.

  - `data.enabled` (boolean)
    Чи ввімкнено доставку для команди.

  - `requestId` (string, required)
    Ідентифікатор запиту операції