Saltar al contenido principal

Webhooks

Conecta Frihet a tu stack en tiempo real: 94 tipos de eventos, firma HMAC y reintentos automaticos.

Overview

Los webhooks de Frihet envian notificaciones HTTP a tu servidor cuando ocurren eventos en la cuenta: facturas creadas o pagadas, gastos nuevos, clientes actualizados, modelos fiscales generados, etc. Cada entrega incluye una firma HMAC-SHA256 en la cabecera X-Frihet-Signature para verificar la autenticidad. Si tu servidor devuelve un error, Frihet reintenta automaticamente con backoff exponencial hasta 5 veces. El log de entregas muestra el historial de intentos por endpoint.

Quick start

  1. Ve a Configuracion → WebhooksNuevo endpoint
  2. Pega la URL de tu servidor y selecciona los tipos de evento que quieres recibir
  3. Copia el secreto de firma y verifica la firma en tu servidor antes de procesar eventos

Reference

  • API: GET /v1/webhooks (listar endpoints), POST /v1/webhooks (crear), DELETE /v1/webhooks/:id
  • MCP tool: manage_webhooks — ver referencia MCP
  • Settings: Configuracion → Desarrolladores → Webhooks