Actions und mehrere Formulare

Mit Actions unterscheidest du Formulare wie Kontakt, Login und Bestellung und wertest sie getrennt aus.

Was eine Action ist

Eine Action ist ein Name für ein Formular, zum Beispiel contact, login, newsletter oder checkout. Der Key akzeptiert nur die bei ihm eingetragenen Actions. Die Auswertung kann danach filtern.

Einrichten

  1. 1Trag beim Key unter „Actions“ alle Namen ein, durch Komma getrennt, klein geschrieben und ohne Leerzeichen.
  2. 2Setz im Widget data-action, oder je Formular data-smartcaptcha-action.
  3. 3Schick im Backend bei /v1/verify dieselbe Action mit.
html
<form data-smartcaptcha data-smartcaptcha-action="login" method="post" action="/login">…</form>
<form data-smartcaptcha data-smartcaptcha-action="contact" method="post" action="/kontakt">…</form>

Passt die Action im Backend nicht zur Action im Widget, lehnt die API mit action_mismatch ab. Ist die Action beim Key nicht eingetragen, erscheint im Dashboard der Hinweis „Formular-Action ist nicht erlaubt“.

Noch Fragen? Wir helfen gern weiter.

Zum Kontaktformular

Stand: 5. Oktober 2026