Skip to main content
Das führt dich vollständig durch das Erstellen eines Formulars im Dashboard, einschließlich des einen manuellen Schritts, den jedes neue Formular braucht: die Verifizierung, wohin seine E-Mails gehen.

Formular erstellen

  1. Melde dich im Dashboard an.
  2. Klicke auf New form.
  3. Gib ihm einen Namen (nur für deine eigene Referenz, Besucher sehen ihn nie) und eine Zieladresse, also wohin Einsendungen gesendet werden.
Formpaste erzeugt einen Zugangsschlüssel (fp_…) für das Formular. Das ist der Wert, den jede Einsendung enthält, um zu sagen, zu welchem Formular sie gehört. Er ist dafür gedacht, im öffentlichen Seitenquelltext zu stehen, er ist kein Bearer-Credential und muss nicht wie ein API-Token geheim gehalten werden.
Es gibt keinen separaten REST-Aufruf zum “Formular erstellen”. Formulare werden im Dashboard erstellt, oder durch einen KI-Agenten über das create_form-Tool des MCP-Servers, beide Wege führen zum selben Ergebnis.

Zieladresse verifizieren

Beim ersten Mal, dass die Zieladresse eines Formulars verwendet wird, sendet Formpaste einen 6-stelligen Code an diese Adresse und hält die Zustellung zurück, bis der Code im Dashboard eingegeben wird. Das gibt es, damit ein Formular nicht auf einen Posteingang gerichtet werden kann, den du nicht kontrollierst, um ihn zuzuspammen, ein Agent, der für dich ein Formular erstellt, kann diesen Schritt nicht selbstständig abschließen (er kann deinen Posteingang nicht lesen), daher ist es immer eine menschliche Aktion.
  1. Öffne den Code in der E-Mail, die dir zugesendet wurde.
  2. Gib ihn im Setup-Tab des Formulars im Dashboard ein.
  3. Sobald verifiziert, beginnt die Zustellung von Einsendungen an diese Adresse sofort.
Wenn du ein zweites Formular mit einer bereits für dein Konto verifizierten E-Mail-Adresse erstellst, beginnt die Zustellung sofort, kein erneutes OTP.

Grundlagen konfigurieren

Im Setup-Tab des Formulars kannst du Folgendes festlegen:
  • Allowed domains - eine Zulassungsliste der Domains, die zu diesem Formular einsenden dürfen. Das, nicht CORS, ist die eigentliche Sicherheitsgrenze (siehe Spam-Filterung).
  • Allow disposable emails - schaltet um, ob Einsendungen von Wegwerf-E-Mail-Anbietern akzeptiert oder unter Quarantäne gestellt werden.
  • Notification subject - eine benutzerdefinierte Betreffzeile für die Benachrichtigungs-E-Mail (notification_subject).
  • Sender display name - der Anzeigename, von dem Einsendungen ankommen (sender_name).
  • Reply-to field mapping - welches eingesendete Feld (z. B. email) zum Reply-To-Header wird, damit du auf “Antworten” klicken und dem Besucher direkt antworten kannst (reply_to_field).
  • Redirect - eine optionale URL, auf der Besucher nach einem No-JS-Versand landen; siehe Umleitungen.

Snippet einfügen

Kopiere den Zugangsschlüssel und den Snippet aus dem Setup-Tab, oder sieh dir Framework-Snippets für die sechs unterstützten Frameworks an (HTML, React, Next.js, Astro, Vue, Svelte), jeweils ein schlichtes, fertig verdrahtetes Formular.

Weiter geht’s

Framework-Snippets

Fertige Snippets für jedes unterstützte Framework.

Spam-Filterung

Wie Einsendungen geprüft werden.

Quarantäne

Wohin verdächtige Einsendungen gehen, statt verworfen zu werden.

MCP-Server

Erstelle und konfiguriere Formulare über einen Agenten statt über das Dashboard.