Pular para o conteúdo
Entrar Lista de espera

Ver webhook

GET /v1/webhooks/:id escopo admin

Um webhook (sem o segredo).

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Parâmetros

Nome Onde Descrição
id caminho Id do webhook (começa com wh_).

Exemplo

curl "https://praeko.app/v1/webhooks/wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "id": "wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R",
  "url": "https://exemplo.com.br/hooks/praeko",
  "events": [
    "post.sent",
    "post.failed"
  ],
  "active": true,
  "secretHint": "whsec_…k3Qw",
  "consecutiveFailures": 0,
  "createdAt": "2026-11-07T14:02:11.482Z",
  "updatedAt": "2026-11-07T14:02:11.482Z"
}

Erros

Status code Quando
404 webhook_not_found O webhook não existe.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.