Ir al contenido

Listar webhooks

Devuelve los endpoints activos de tu empresa. El secret nunca vuelve a mostrarse: si lo perdiste, elimina el endpoint y regístralo de nuevo.

Ventana de terminal
curl https://faktura-test.cgallardo.me/v1/webhooks -H "Authorization: Bearer sk_test_..."

Método: GET

GET https://faktura-test.cgallardo.me/v1/webhooks
{
"items": [
{
"id": "01a1d6b2-4c1e-7f30-9a2b-5d8e7c6b1a00",
"url": "https://erp.miempresa.pe/faktura/webhook",
"events": ["document.accepted", "document.rejected"],
"is_active": true,
"created_at": "2026-11-13T22:00:00+00:00"
}
]
}
Campo Descripción
id Identificador del endpoint, para eliminarlo.
url URL que recibe los avisos.
events Eventos suscritos (lista de eventos).
is_active true mientras recibe avisos.
created_at Fecha de registro (UTC, ISO 8601).
Estado reason Significado
200 — Devuelve la lista de webhooks activos de tu empresa.
401 Unauthenticated Falta la API key, es inválida o venció.
403 ApiKeyScopeInsufficient La clave es de alcance lookup.
429 TooManyRequests Superaste las 120 peticiones por minuto.