Doku:Formular anbinden

Erste Schritte

Formular anbinden

Ein HTML-Formular in wenigen Minuten an Mailiy anbinden: Endpunkt, Zugangsschlüssel, Beispiele für HTML und JavaScript.

Dashboard-Ausschnitt: Formulare › dein Formular › Einrichtung
Im Dashboard unter Formulare › dein Formular › Einrichtung

Mailiy nimmt Formulardaten per POST entgegen und schickt sie als E-Mail an deine bestätigten Adressen. Es akzeptiert application/x-www-form-urlencoded, multipart/form-data und JSON (max. 128 KB, 50 Felder).

Endpoint: https://mailiy.com/api/submit

Den Schlüssel kannst du statt im Feld access_key auch in die URL schreiben: https://mailiy.com/api/submit/YOUR-KEY

Fertige Formulare findest du in den Vorlagen, Schritte für WordPress, Webflow und Framer in den Anleitungen.

HTML

<form action="https://mailiy.com/api/submit" method="POST">
  <input type="hidden" name="access_key" value="YOUR-KEY">
  <input type="hidden" name="subject" value="Neue Kontaktanfrage">
  <input type="text" name="name" required>
  <input type="email" name="email" required>
  <textarea name="message" required></textarea>
  <label><input type="checkbox" name="consent" value="yes" required> Ich stimme der Verarbeitung zu.</label>
  <input type="checkbox" name="botcheck" class="hidden" style="display:none">
  <button type="submit">Senden</button>
</form>

Ohne JavaScript leitet Mailiy nach dem Absenden auf die Danke-Seite weiter (HTTP 303) oder auf deine eigene URL. Fehler landen mit ?error=code auf derselben Seite.

JavaScript

const res = await fetch("https://mailiy.com/api/submit", {
  method: "POST",
  headers: { "Content-Type": "application/json", Accept: "application/json" },
  body: JSON.stringify({ access_key: "YOUR-KEY", email, message }),
});
const { success, message } = await res.json();

Sendest du JSON oder den Header Accept: application/json, antwortet Mailiy mit JSON statt einer Weiterleitung.

Ohne eigenen Code geht es mit unserem Skript. Es schickt jedes Formular, dessen action auf Mailiy zeigt, im Hintergrund ab und schreibt die Antwort unter das Formular:

<script src="https://mailiy.com/client/script.js" defer></script>

Eigene Texte, Events und Weiterleitung stehen in den Anleitungen.