API y webhooks

API y webhooks de Formify: firma electrónica en tus propios sistemas

Formify cuenta con una API REST con OAuth 2.0 y webhooks firmados con HMAC. Tu desarrollador puede enviar documentos para su firma desde tu propio sistema, y recibirás una notificación cuando se abran, se firmen o se sellen.

Última actualización: 17 de noviembre de 2026. Revisado por David Nordin

Datos clave

Niveles de firmaFirma electrónica simple con tinta (SES) y firma electrónica avanzada (AES) con pasaporte y selfie en vídeo según el Reglamento eIDAS
InvitacionesCorreo electrónico, SMS o WhatsApp
Idiomas de la invitaciónInglés, sueco y español
PDF firmadoCertificado con un certificado válido expedido por un proveedor incluido en la Lista de Confianza de la UE
Dónde se almacenan los datosLos documentos y los datos se almacenan en la UE, siendo Suecia la región principal (donde se almacenan tus datos).
CosteEmpieza gratis con 10 « créditos » al mes. Recarga a partir de 10 €, o elige una plaza a partir de 25 € al mes. La conexión MCP no tiene ningún coste adicional. Precios sin IVA. (créditos)
AutenticaciónOAuth 2.0 o clave de API
FormatosOpenAPI, Markdown y llms.txt
créditos por envíoLos documentos enviados a través de la API utilizan la firma digital « créditos » de tu monedero de Formify: 2 créditos para una firma sencilla con tinta, y 8 con pasaporte y un selfi en vídeo. (créditos)

Qué puedes hacer

  • Envía el formulario KYC desde tu propio portal de clientes cuando se registre un nuevo comprador de una vivienda.
  • Recibe una notificación en cuanto todas las partes hayan firmado (document.completed) y guarda el PDF sellado en tu propio sistema.
  • Solicitar el pasaporte y un selfie en vídeo (AES) durante el proceso de firma.
  • Rellena los campos y bloquéalos antes de enviarlos, para que el cliente solo tenga que rellenar la parte que le corresponde.
  • Importa las respuestas del firmante directamente a tu propio sistema.

Eventos de webhook

EventoCuando se envía
document.createdSe ha creado un documento y se ha enviado para su firma.
document.openedSe ha abierto el documento.
document.signedUn firmante ha firmado. La carga útil también incluye signeeId.
document.completedTodas las partes han firmado y el documento está sellado.
document.revokedEl documento ha sido revocado.
document.deletedEl documento se ha eliminado.

Cada evento contiene eventId, type, date (ISO 8601) y data con documentId, accountId y userId. Solo se envían los eventos de documento.

Empezar

  1. Crea una cuenta gratuita en Formify.
  2. Pide a tu desarrollador que lea la referencia de la API.
  3. Crea credenciales: OAuth 2.0 o una clave API en la aplicación Formify, en la sección «Configuración», «Integración».
  4. Registra un webhook en la dirección en la que tu sistema está a la escucha.

Lista de comprobación de la producción

Qué funciona y cómo

Lo que quieresEstadoCómo funciona
Saber cuándo se ha firmado o sellado un documentoSe busca un desarrolladorWebhooks document.signed y document.completed
Comprueba que el webhook proceda realmente de FormifySe busca un desarrolladorHMAC-SHA256 con el punto final del whsec_ secreto
Recibe notificaciones sin necesidad de un desarrolladorFunciona nada más sacarlo de la cajaEn «Make», con «Ver documentos finalizados»
Envíalo junto con el pasaporte y un vídeo en el que salgas tú mismoSe busca un desarrolladorTipo de firma signatureFaceLiveness
Descarga el PDF firmadoSe busca un desarrolladorUn enlace con límite de tiempo, válido durante 10 minutos
Webhooks para cambios en la configuración o en la cuentaNo disponibleSolo se admiten eventos de documento
Prueba sin datos de producciónSe busca un desarrolladorsk_test_ claves en entornos de prueba

Preguntas frecuentes

¿Formify tiene una API?

Sí. Formify cuenta con una API REST que utiliza JSON y credenciales de cliente OAuth 2.0. Cada herramienta del servidor MCP de Formify se corresponde con un punto final REST, y la documentación de referencia se publica en formato OpenAPI, Markdown y llms.txt en developers.formify.eu. En el caso de las herramientas que no puedan utilizar OAuth, puedes crear una clave API en la aplicación de Formify, en la sección «Configuración», «Integración».

¿Qué eventos de webhook envía Formify?

Seis, todos relacionados con los documentos: document.created, document.opened, document.signed, document.completed, document.revoked y document.deleted. Cada webhook se firma con HMAC-SHA256 utilizando un secreto exclusivo del punto final, para que tu sistema pueda comprobar que procede de Formify. Puedes cambiar el secreto cuando lo necesites.

¿Qué ocurre si nuestro servidor está fuera de servicio cuando se envía un webhook?

Formify lo vuelve a intentar hasta cinco veces: inmediatamente, y luego al cabo de unos 5 minutos, 30 minutos, 2 horas y 24 horas. Tu servidor confirma la entrega con una respuesta 2xx. Un evento puede llegar más de una vez o en un orden incorrecto, por lo que tu desarrollador debe utilizar el «eventId» para omitir los duplicados.

¿Podemos añadir la verificación de identidad a través de la API?

Sí. Con el tipo de firma «signatureFaceLiveness», el firmante escanea su pasaporte y graba un vídeo selfie antes de firmar. De este modo se obtiene una firma electrónica avanzada (AES) según el Reglamento eIDAS. Para una firma sencilla con tinta, utiliza «digital_ink».

No tenemos ningún desarrollador. ¿Qué podemos hacer?

Utiliza Make. La aplicación Formify en Make cuenta con módulos ya preparados, como «Ver documentos completados», que inicia un escenario cuando se completa un documento, lo que te permite actuar sobre los documentos firmados sin necesidad de escribir código. Si prefieres enviar y realizar el seguimiento desde el chat, conecta Formify a ChatGPT o Claude.

¿En qué se diferencia esta página de la documentación para desarrolladores?

En esta página se explica qué se puede crear con la API y los webhooks de Formify, y qué se necesita para ello. La documentación de la API y la referencia de la API están dirigidas a desarrolladores e incluyen todos los puntos finales, parámetros y ejemplos de código.