Cadastrar webhook

POST/webhooks

Cadastre a URL e os eventos (vazio = todos). Guarde o segredo da resposta: ele não aparece de novo.

Corpo da requisição

urlobrigatório

stringURL HTTPS que recebe os eventos.

descricao

stringDescrição.

eventos

string[]Vazio = todos.

Retorno

201 Created

Autenticação

Bearer sk_test_ / sk_live_

curl -X POST https://api.seelo.com.br/v1/webhooks \
  -H "Authorization: Bearer sk_test_••••" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://erp.exemplo.com.br/webhooks/nfse",
    "eventos": [
      "nfse.autorizada",
      "nfse.rejeitada",
      "nfse.cancelada"
    ]
  }'

201

{
  "id": "0f9e8d7c-6b5a-4433-9221-1a2b3c4d5e6f",
  "objeto": "webhook",
  "url": "https://erp.exemplo.com.br/webhooks/nfse",
  "eventos": [
    "nfse.autorizada",
    "nfse.rejeitada",
    "nfse.cancelada"
  ],
  "descricao": null,
  "ativo": true,
  "criado_em": "2026-11-01T14:00:00-03:00",
  "modo": "live",
  "segredo": "whsec_9f2a41ccd0b17e5c3a"
}