Pular para o conteúdo
Entrar Lista de espera

Listar webhooks

GET /v1/webhooks escopo admin

Webhooks de saída deste workspace (nunca o segredo: só secretHint), com o sucesso das entregas dos últimos 7 dias (recentDeliveries) e os events que dá para assinar.

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

Exemplo

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

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "webhooks": [
    {
      "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",
      "recentDeliveries": {
        "total": 12,
        "ok": 12
      }
    }
  ],
  "events": [
    "post.sent",
    "post.failed",
    "post.scheduled-fail"
  ]
}

Erros

Sem erros específicos desta rota além dos comuns.

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.