Inicio > Integraciones > 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 firma | Firma electrónica simple con tinta (SES) y firma electrónica avanzada (AES) con pasaporte y selfie en vídeo según el Reglamento eIDAS |
|---|---|
| Invitaciones | Correo electrónico, SMS o WhatsApp |
| Idiomas de la invitación | Inglés, sueco y español |
| PDF firmado | Certificado con un certificado válido expedido por un proveedor incluido en la Lista de Confianza de la UE |
| Dónde se almacenan los datos | Los documentos y los datos se almacenan en la UE, siendo Suecia la región principal (donde se almacenan tus datos). |
| Coste | Empieza 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ón | OAuth 2.0 o clave de API |
| Formatos | OpenAPI, Markdown y llms.txt |
| créditos por envío | Los 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
| Evento | Cuando se envía |
|---|---|
document.created | Se ha creado un documento y se ha enviado para su firma. |
document.opened | Se ha abierto el documento. |
document.signed | Un firmante ha firmado. La carga útil también incluye signeeId. |
document.completed | Todas las partes han firmado y el documento está sellado. |
document.revoked | El documento ha sido revocado. |
document.deleted | El 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
- Crea una cuenta gratuita en Formify.
- Pide a tu desarrollador que lea la referencia de la API.
- Crea credenciales: OAuth 2.0 o una clave API en la aplicación Formify, en la sección «Configuración», «Integración».
- Registra un webhook en la dirección en la que tu sistema está a la escucha.
Qué funciona y cómo
| Lo que quieres | Estado | Cómo funciona |
|---|---|---|
| Saber cuándo se ha firmado o sellado un documento | Se busca un desarrollador | Webhooks document.signed y document.completed |
| Comprueba que el webhook proceda realmente de Formify | Se busca un desarrollador | HMAC-SHA256 con el punto final del whsec_ secreto |
| Recibe notificaciones sin necesidad de un desarrollador | Funciona nada más sacarlo de la caja | En «Make», con «Ver documentos finalizados» |
| Envíalo junto con el pasaporte y un vídeo en el que salgas tú mismo | Se busca un desarrollador | Tipo de firma signatureFaceLiveness |
| Descarga el PDF firmado | Se busca un desarrollador | Un enlace con límite de tiempo, válido durante 10 minutos |
| Webhooks para cambios en la configuración o en la cuenta | No disponible | Solo se admiten eventos de documento |
| Prueba sin datos de producción | Se busca un desarrollador | sk_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.
