Skip to main content
Si estás buscando un endpoint GET /api/submissions que consultar, no existe. Formpaste no incluye una API REST de propósito general para leer datos de envíos. Eso no es un descuido; es la forma actual del producto. Hay tres formas reales de sacar los envíos, cubriendo el panel, la exportación masiva, y los casos de uso con agentes.

​
1. El inbox del panel

Cada formulario tiene una pestaña Inbox (y una pestaña Spam para los envíos en cuarentena) en el panel. Esta es la vista principal, siempre actualizada, cada envío que pasa el filtrado de spam aparece aquí en el momento en que llega, junto con la copia enviada por correo a tu dirección de destino. Úsala cuando un humano quiera leer envíos.

​
2. Exportación CSV

Para uso masivo o sin conexión, exporta los envíos como CSV:
  • Por formulario: desde la pestaña Inbox de un formulario, exporta todos los envíos de ese formulario.
  • De toda la cuenta: desde Settings → Data & privacy, exporta todos los envíos de todos los formularios de la cuenta en un archivo.
Ambas están limitadas al propietario, solo puedes exportar formularios que posees, y respetan la ventana de retención de la cuenta. Consulta Exportación CSV para el diseño exacto de las columnas. Úsala para hojas de cálculo, análisis puntuales, o para alimentar envíos a una herramienta que no necesita acceso programático en vivo.

​
3. La herramienta MCP list_submissions

Para un agente (o cualquier cliente que hable MCP) que necesite acceso de lectura programático y bajo demanda, el servidor MCP expone list_submissions, lo más parecido a una API para leer envíos, y la que realmente es real:
Devuelve los contadores de inbox/spam más una página de envíos, solo metadatos por defecto (id, created_at, folder, status), pasa includeContent: true para obtener también los campos enviados (nombre, correo, mensaje, etc.), lo cual es opcional específicamente porque esos datos son información personal del visitante, no del propietario del formulario. Consulta list_submissions para el esquema completo de entrada/salida. Úsala cuando un agente necesite verificar “¿alguien envió algo hoy?” o resumir mensajes recientes sin que un humano abra el panel.

​
Lo que no existe

No hay ningún GET /api/submissions, ningún GET /api/forms/{id}/submissions, ningún endpoint REST de consulta, y ninguna “API de envíos” independiente de los webhooks más allá de los tres caminos de arriba. Si necesitas que los datos de envíos fluyan a tu propio sistema automáticamente conforme llegan, en lugar de extraerse bajo demanda, para eso están los webhooks (Pro): un POST firmado se activa por cada envío entregado en tiempo real.

list_submissions

Esquema completo de la herramienta MCP.

Webhooks

Empuje, no extracción, entrega en tiempo real a tu propio endpoint.

Exportación CSV

Exportación masiva, por formulario o de toda la cuenta.

Historial de envíos

Ventanas de retención que limitan los tres caminos de recuperación.