Crear un webhook
Registra una URL para recibir eventos en el ambiente de la API key; el ambiente no se envía en el body. La URL debe ser HTTPS y pública. Cada contribuyente puede tener hasta cinco webhooks activos por ambiente.
El secreto whsec_… con el que se firman las notificaciones se devuelve únicamente en esta
respuesta: guardalo. Para obtener uno nuevo, rotalo.
No admite Idempotency-Key: el header se rechaza con 400 idempotency-not-supported.
Si un reintento encuentra la URL ya registrada, responde 400 validation-error; en ese caso
consultá el listado.
Authorization
apiKey API key de Sifende en el header Authorization: Bearer {api-key}.
Además de autenticar, fija el contribuyente emisor y un ambiente inmutable DEV, PROD o
SANDBOX: por eso ninguno de los dos se envía en el body.
En PROD, la clave requiere un plan que incluya la API de integración; si no, toda ruta
responde 403 plan-operation-not-allowed.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/json
application/problem+json
curl -X POST "https://example.com/api/v1/contribuyente/webhooks" \ -H "Content-Type: application/json" \ -d '{ "url": "string", "eventos": [ "documento.aprobado" ] }'creado
{ "endpoint": { "id": 42, "url": "https://erp.ejemplo.com.py/sifende/webhook", "ambiente": "PROD", "eventos": [ "documento.aprobado", "documento.rechazado" ], "activo": true, "fechaCreacion": "2026-10-20T14:03:11Z", "fechaEdicion": "2026-10-20T14:03:11Z", "fechaRotacionSecreto": "2026-10-20T14:03:11Z" }, "secreto": "whsec_8Kq2m5N0vXrT1bYc3LdWz9AeJfHpU4sG"}