> ## Documentation Index
> Fetch the complete documentation index at: https://formpaste.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Optionsreferenz

> Jedes reservierte /submit-Feld und jede Dashboard-Option pro Formular, an einem Ort.

Zwei Arten von "Optionen" gelten für ein Formpaste-Formular: Felder, die du direkt in das
`<form>` einfügst und die von `/submit` gelesen werden, und Konfiguration pro Formular, die du einmal
im Dashboard einstellst. Diese Seite ist die vollständige Liste von beidem.

## Reservierte Felder (im Formular-Body)

Diese Feldnamen werden von `/submit` selbst gelesen, setze sie als Inputs in deinem Formular (oder
als Keys in deinem JSON-/`FormData`-Body). Jeder andere Feldname gehört dir.

| Feld         | Erforderlich | Zweck                                                                                                                                                                                                                                                                                                    |
| ------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `access_key` | **Ja**       | Identifiziert, zu welchem Formular die Einsendung gehört (`fp_…`). Ohne dieses Feld, oder mit einem ungültigen Wert, wird die Einsendung abgelehnt, siehe `missing_access_key` / `invalid_access_key` in der [Fehlerreferenz](/docs/de/reference/error-table).                                                |
| `botcheck`   | Nein         | Honeypot. Ein verstecktes Feld, das echte Besucher nie ausfüllen. Kommt es nicht-leer an, wird die Einsendung unter Quarantäne gestellt. Siehe [Spam-Filterung](/docs/de/features/spam-filtering).                                                                                                            |
| `_ts`        | Nein         | Zeitstempel, wann das Formular gerendert wurde, wird für zeitbasierte Spam-Heuristiken verwendet, eine Einsendung, die unplausibel schnell eintrifft, wird als verdächtig eingestuft.                                                                                                                    |
| `redirect`   | Nein         | Eine URL, zu der der Besucher nach einem erfolgreichen No-JS-Versand per `303` weitergeleitet wird. Muss auf der Liste der [erlaubten Domains](/docs/de/features/custom-domains) des Formulars stehen, sonst schlägt die Einsendung mit `invalid_redirect` fehl. Siehe [Umleitungen](/docs/de/features/redirects). |

```html theme={null}
<form action="https://api.formpaste.com/submit" method="POST">
  <input type="hidden" name="access_key" value="YOUR_ACCESS_KEY">
  <input type="text" name="botcheck" style="display:none" tabindex="-1" autocomplete="off">
  <input type="hidden" name="_ts" value="1720700000000">
  <input type="hidden" name="redirect" value="https://example.com/thank-you">
  <input type="email" name="email" placeholder="Your email" required>
  <textarea name="message" placeholder="Your message" required></textarea>
  <button type="submit">Send</button>
</form>
```

Nur `access_key` ist erforderlich. Die anderen drei sind optional, füge `botcheck` und `_ts` hinzu, um
die Spam-Erkennung zu verstärken, füge `redirect` nur für No-JS-Formulare hinzu, die nach dem Versand eine
Navigation benötigen.

## Konfiguration pro Formular (Dashboard)

Diese werden nicht mit jedem Request mitgesendet, du legst sie einmal pro Formular fest, über den
Setup-Tab dieses Formulars im [Dashboard](https://app.formpaste.com) (oder über das MCP-Tool
[`create_form`](/docs/agents/create-form) für die anfängliche Zieladresse). Sie
bestimmen, wie sich ein Formular bei jeder eingehenden Einsendung verhält.

| Option                     | Feld                                        | Tarif     | Hinweise                                                                                                                                                                                                                    |
| -------------------------- | ------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Zieladresse                | -                                           | Kostenlos | Wohin Benachrichtigungen gesendet werden. Muss [verifiziert](/docs/de/first-form#verify-the-destination-email) sein (OTP), bevor die Zustellung beginnt.                                                                         |
| Erlaubte Domains           | `allowed_domains`                           | Kostenlos | Origin-Zulassungsliste, die eigentliche Sicherheitsgrenze hinter `access_key`. Leere Liste = jede Origin. Siehe [Domain-Zulassungsliste](/docs/de/features/custom-domains).                                                      |
| Wegwerf-E-Mails erlauben   | `allow_disposable_email`                    | Kostenlos | Standardmäßig aus; E-Mails von Wegwerf-Anbietern werden unter Quarantäne gestellt, sofern dies nicht aktiviert ist.                                                                                                         |
| Benachrichtigungsbetreff   | `notification_subject`                      | Kostenlos | Benutzerdefinierte Betreffzeile für die Benachrichtigungs-E-Mail. ≤ 200 Zeichen.                                                                                                                                            |
| Anzeigename des Absenders  | `sender_name`                               | Kostenlos | Anzeigename, von dem die Benachrichtigungs-E-Mail zu stammen scheint. ≤ 100 Zeichen.                                                                                                                                        |
| Reply-to-Feldzuordnung     | `reply_to_field`                            | Kostenlos | Welches eingesendete Feld (z. B. `email`) zum `Reply-To`-Header der Benachrichtigung wird.                                                                                                                                  |
| Umleitung (bei Einsendung) | `redirect`                                  | Kostenlos | Siehe die Tabelle der reservierten Felder oben, wird pro Einsendung festgelegt, nicht pro Formular, aber die Zulassungsliste, die dies steuert, gilt auf Formularebene.                                                     |
| Zusätzliche Empfänger      | `additional_recipients`                     | Pro       | Zusätzliche **An**-Adressen. Zusammen mit `cc_recipients` auf 9 begrenzt (10 insgesamt mit dem primären Empfänger). Jede muss einzeln verifiziert werden. Siehe [Mehrere Empfänger & CC](/docs/de/features/multiple-recipients). |
| CC-Empfänger               | `cc_recipients`                             | Pro       | Adressen, die die Benachrichtigung als CC erhalten. Gleiche Obergrenze und Verifizierungsregel wie oben.                                                                                                                    |
| Autoresponder              | `autoresponder_enabled` + zugehörige Felder | Pro       | Automatische Antwort an den Einsender. Siehe [Autoresponder](/docs/de/features/autoresponder) für die vollständige Feldliste und die Schutzmechanismen.                                                                          |
| Webhook-URL                | `webhook_url`                               | Pro       | Signierter HTTPS-POST bei jeder zugestellten Einsendung. Siehe [Webhooks](/docs/de/features/webhooks).                                                                                                                           |

<Note>
  Es gibt keinen Konfigurations-Endpunkt zum Aufrufen, das sind reine Dashboard-Einstellungen. Der MCP-Server
  stellt kein `update_form`-Tool bereit; wenn du eine dieser Einstellungen nach
  `create_form` ändern musst, tu das im Dashboard. Siehe [MCP-Server](/docs/agents/mcp-server#the-three-tools).
</Note>

## Kostenlos- vs. Pro-Felder

Der Versuch, ein Pro-gesperrtes Feld (`additional_recipients`, `cc_recipients`,
`autoresponder_enabled`, `webhook_url`) auf einem Formular im kostenlosen Tarif zu setzen, schlägt beim Speichern fehl:

| Code               | HTTP | Bedeutung                                 |
| ------------------ | ---- | ----------------------------------------- |
| `upgrade_required` | 403  | Dieses Feature erfordert einen Pro-Tarif. |

<CardGroup cols={2}>
  <Card title="Fehlerreferenz" icon="triangle-exclamation" href="/docs/de/reference/error-table">
    Jeder `/submit`-Fehlercode, HTTP-Status und Bedeutung.
  </Card>

  <Card title="Dein erstes Formular" icon="inbox" href="/docs/de/first-form">
    Die Dashboard-Anleitung, aus der diese Optionen stammen.
  </Card>
</CardGroup>