Actualizar un webhook
Reemplaza la URL, los eventos y el estado del webhook; el ambiente no cambia. activo: false
pausa el webhook y cancela sus entregas pendientes. Reactivarlo respeta el límite de cinco
webhooks activos por ambiente. El secreto no cambia: para eso, rotalo.
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
Path Parameters
Identificador del webhook, tal como lo devuelve el listado
int64Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/json
application/problem+json
application/problem+json
curl -X PUT "https://example.com/api/v1/contribuyente/webhooks/42" \ -H "Content-Type: application/json" \ -d '{ "url": "string", "eventos": [ "documento.aprobado" ], "activo": true }'webhook
{ "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"}