# Configurar el webhook del equipo

Crea o reemplaza la configuración de webhook del equipo.
- **Requisitos previos**: `callbackUrl` debe ser una URL HTTPS de 1 a 1024 caracteres, con host, sin información de usuario, sin fragmento y con un puerto válido. Todas las direcciones a las que resuelva deben ser enrutables públicamente; se rechazan los rangos de localhost, privados, link-local, CGNAT, metadatos de nube, reservados por protocolo, de documentación y 6to4. La misma comprobación se repite cuando una entrega abre su conexión, así que un nombre que más tarde resuelva a un rango privado hace fallar esa entrega en lugar de llegar a tu red.
- **Efecto**: hace un upsert de la única configuración del equipo del contexto del servidor. `teamId` nunca se lee de la petición, así que quien llama no puede configurar otro equipo. Los endpoints de la Local API y la Open API leen y escriben el mismo registro, y la respuesta refleja lo que se almacenó.
- **Desactivación**: `enabled: false` mantiene la URL y detiene la creación de nuevos eventos. Los eventos ya en cola se cancelan uno a uno si la configuración sigue desactivada cuando les toca autorizarse, así que reactivarla pronto permite que continúen.
- **Reintento**: seguro. El guardado es un upsert por equipo, así que repetir la misma petición converge en el mismo estado.
- **Versión del cliente**: requiere el cliente de MoreLogin v2.66.0 o superior, porque es el cliente de escritorio el que expone esta ruta en local. El endpoint de la Open API no depende del cliente.

Consulta [Webhooks](../Getting%20Started/webhooks.md) para el contrato de callback, los nombres de evento y el calendario de reintentos.
Errores de negocio documentados: `41001`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

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

## Request fields (application/json):

  - `callbackUrl` (string, required)
    URL HTTPS que recibe los eventos. De 1 a 1024 caracteres.

  - `enabled` (boolean, required)
    Indica si la entrega está activada para el equipo.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado. `0` indica éxito; otros códigos indican excepciones.

  - `msg` (string | null, required)
    Mensaje de error

  - `data` (object, required)

  - `data.callbackUrl` (string)
    La URL HTTPS de callback almacenada.

  - `data.enabled` (boolean)
    Indica si la entrega está activada para el equipo.

  - `requestId` (string, required)
    ID de solicitud de la operación