Skip to main content
Falls du nach einem GET /api/submissions-Endpunkt suchst, den du abfragen kannst: den gibt es nicht. Formpaste bietet keine allgemeine REST-API zum Lesen von Einsendungsdaten. Das ist kein Versehen, das ist die aktuelle Form des Produkts. Es gibt drei tatsächliche Wege, um Einsendungen abzurufen, sie decken den Dashboard-, den Bulk-Export- und den Agenten-Anwendungsfall ab.

​
1. Der Posteingang im Dashboard

Jedes Formular hat einen Posteingang-Tab (und einen Spam-Tab für unter Quarantäne gestellte Einsendungen) im Dashboard. Das ist die primäre, stets aktuelle Ansicht, jede Einsendung, die die Spam-Filterung passiert, erscheint hier in dem Moment, in dem sie eintrifft, zusammen mit der Kopie, die an deine Zieladresse gemailt wurde. Nutze das, wenn ein Mensch Einsendungen lesen möchte.

​
2. CSV-Export

Für Bulk- oder Offline-Nutzung kannst du Einsendungen als CSV exportieren:
  • Pro Formular: Exportiere aus dem Posteingang-Tab eines Formulars jede Einsendung dieses Formulars.
  • Kontoweit: Exportiere unter Einstellungen → Daten & Datenschutz jede Einsendung über alle Formulare des Kontos hinweg in einer Datei.
Beide sind besitzerbezogen, du kannst nur Formulare exportieren, die dir gehören, und sie berücksichtigen das Aufbewahrungsfenster des Kontos. Siehe CSV-Export für das genaue Spaltenlayout. Nutze das für Tabellenkalkulationen, einmalige Analysen oder um Einsendungen in ein Tool einzuspeisen, das keinen Live-/programmatischen Zugriff benötigt.

​
3. Das MCP-Tool list_submissions

Für einen Agenten (oder jeden MCP-fähigen Client), der programmatischen, bedarfsgesteuerten Lesezugriff benötigt, stellt der MCP-Server list_submissions bereit, das Nächste, was es zu einer API zum Lesen von Einsendungen gibt, und das einzige, das tatsächlich real ist:
Es liefert Posteingang-/Spam-Zähler sowie eine Seite mit Einsendungen, standardmäßig nur mit Metadaten (id, created_at, folder, status), übergib includeContent: true, um auch die eingesendeten Felder zu erhalten (Name, E-Mail, Nachricht usw.), was deshalb explizit optional ist, weil diese Daten die personenbezogenen Daten des Besuchers sind, nicht die des Formularinhabers. Siehe list_submissions für das vollständige Ein-/Ausgabeschema. Nutze das, wenn ein Agent prüfen muss, “hat heute jemand etwas eingesendet?”, oder aktuelle Nachrichten zusammenfassen soll, ohne dass ein Mensch das Dashboard öffnet.

​
Was es nicht gibt

Es gibt kein GET /api/submissions, kein GET /api/forms/{id}/submissions, keinen abfragbaren REST-Endpunkt und keine von Webhooks unabhängige “Submissions-API” jenseits der drei oben genannten Wege. Wenn Einsendungsdaten automatisch in dein eigenes System fließen sollen, sobald sie eintreffen, statt bei Bedarf abgerufen zu werden, dann sind Webhooks (Pro) dafür da: Ein signierter POST wird bei jeder zugestellten Einsendung in Echtzeit ausgelöst.

list_submissions

Vollständiges Schema für das MCP-Tool.

Webhooks

Push, nicht Pull, Echtzeit-Zustellung an deinen eigenen Endpunkt.

CSV-Export

Bulk-Export, pro Formular oder kontoweit.

Einsendungsverlauf

Aufbewahrungsfenster, die alle drei Abrufwege begrenzen.