Cadastrar webhook

POST/v1/webhooks

🔒 Requer Bearer token

Cadastra uma URL para receber o resultado das propostas. Retorna o secret (mostrado só aqui) usado para validar a assinatura HMAC-SHA256 no header X-Webhook-Signature. Eventos: proposta.atualizada. Escopo: leilao:enviar.

Corpo da requisição

urlstringobrigatório

URL HTTPS que receberá as entregas.

eventosarray<string>opcional

Eventos assinados. Opcional — se omitido, assina todos os disponíveis.

proposta.atualizada

Respostas

Corpo da resposta 201

Corpo não descrito no spec desta API.

Request

curl -X POST 'https://econsignado-api-leilao.socinal.com.br/v1/webhooks' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://parceiro.exemplo.com/webhooks/socinal-leilao",
  "eventos": [
    "proposta.atualizada"
  ]
}'

Response

Webhook criado; o `secret` é exibido apenas nesta resposta.