# Configurar o webhook da equipe

Cria ou substitui a configuração de webhook da equipe.
- **Pré-requisitos**: `callbackUrl` deve ser uma URL HTTPS de 1 a 1024 caracteres, com host, sem informações de usuário, sem fragmento e com porta válida. Todos os endereços para os quais ela resolver precisam ser roteáveis publicamente; faixas de localhost, privadas, link-local, CGNAT, metadados de nuvem, reservadas por protocolo, de documentação e 6to4 são rejeitadas. A mesma verificação ocorre de novo quando uma entrega abre a conexão, então um nome que depois resolva para uma faixa privada faz aquela entrega falhar em vez de alcançar sua rede.
- **Efeito**: faz upsert da única configuração da equipe do contexto do servidor. `teamId` nunca é lido da requisição, então quem chama não pode configurar outra equipe. Os endpoints da Local API e da Open API leem e gravam o mesmo registro, e a resposta reflete o que foi armazenado.
- **Desativação**: `enabled: false` mantém a URL e interrompe a criação de novos eventos. Eventos já na fila são cancelados um a um se a configuração ainda estiver desativada quando forem autorizados, então reativar logo permite que continuem.
- **Repetição**: seguro. O salvamento é um upsert por equipe, então repetir a mesma requisição converge para o mesmo estado.
- **Versão do cliente**: requer o cliente MoreLogin v2.66.0 ou superior, porque é o cliente de desktop que expõe essa rota localmente. O endpoint da Open API não depende do cliente.

Consulte [Webhooks](../Getting%20Started/webhooks.md) para o contrato de callback, os nomes de evento e a programação de novas tentativas.
Erros de negócio documentados: `41001`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

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

## Request fields (application/json):

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

  - `enabled` (boolean, required)
    Indica se a entrega está ativada para a equipe.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado. `0` indica sucesso; outros códigos indicam exceções.

  - `msg` (string | null, required)
    Mensagem de erro

  - `data` (object, required)

  - `data.callbackUrl` (string)
    A URL HTTPS de callback armazenada.

  - `data.enabled` (boolean)
    Indica se a entrega está ativada para a equipe.

  - `requestId` (string, required)
    ID da solicitação da operação