Ir al contenido

Registrar un webhook

Ventana de terminal
curl -X POST https://faktura-test.cgallardo.me/v1/webhooks \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{ "url": "https://erp.miempresa.pe/faktura/webhook", "events": ["document.accepted", "document.rejected"] }'

Método: POST

POST https://faktura-test.cgallardo.me/v1/webhooks
Campo Obligatorio Descripción
url Sí HTTPS, accesible desde internet, sin usuario ni contraseña en la URL.
events No Lista de eventos; si se omite, recibe todos.
{
"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",
"secret": "whsec_3f9c…"
}

Guarda el secret: solo se muestra esta vez. Sirve para verificar la firma de cada aviso.

Estado reason Causa
409 TooManyWebhooks Tu empresa ya tiene 10 endpoints, el máximo. Elimina uno antes de registrar otro.
422 InvalidWebhookUrl La URL no es HTTPS, lleva usuario o contraseña, o apunta a una red privada.
422 ValidationFailed Falta url o events trae un evento desconocido.

Los eventos y el formato del aviso están en Cómo funcionan los webhooks.