HTML-Formular

Kein JavaScript nötig: Ein normales HTML-Formular sendet direkt an die Lead-API. Nach dem Absenden leitet Advision360 den Besucher auf Ihre Danke-Seite weiter.

<form action="https://app.advision360.de/api/public/leads" method="POST">
  <input type="hidden" name="_key" value="YOUR_API_KEY" />
  <input type="hidden" name="_redirect" value="https://www.example.com/danke" />

  <input type="text" name="firstName" placeholder="Vorname" required />
  <input type="text" name="lastName" placeholder="Nachname" required />
  <input type="email" name="email" placeholder="E-Mail" />
  <input type="tel" name="phone" placeholder="Telefon" />
  <input type="text" name="additionalFields.company_size" placeholder="Firmengröße" />

  <button type="submit">Senden</button>
</form>

Die API akzeptiert application/x-www-form-urlencoded (Standard eines HTML-Formulars) und multipart/form-data. Die Feldnamen entsprechen der API-Referenz.

Versteckte Felder

Feld	Pflicht	Beschreibung
_key	ja	Ihr Lead-Schlüssel.
_redirect	nein	Adresse, zu der nach erfolgreicher Übermittlung weitergeleitet wird.
_test	nein	1 markiert den Lead als Test-Lead.

Eigene Werte senden Sie mit dem Präfix additionalFields., z. B. additionalFields.company_size. Siehe Eigene Felder.

Weiterleitung

Advision360 leitet nur auf Domains weiter, die beim Lead-Schlüssel unter Erlaubte Weiterleitungsdomains eingetragen sind (Einstellungen → Lead- & Formular-Schlüssel → Schlüssel bearbeiten).

• Die Adresse in _redirect muss absolut sein und mit http:// oder https:// beginnen.
• Der Host muss exakt einer eingetragenen Domain entsprechen. example.com und www.example.com sind verschiedene Einträge.
• Ist die Domain nicht freigegeben oder fehlt _redirect, wird nicht weitergeleitet. Der Lead wird trotzdem angelegt, und der Browser zeigt die JSON-Antwort {} an.

Bei erfolgreicher Weiterleitung antwortet die API mit 302 Found und dem Header Location.

:::tip Fehler sichtbar machen

Bei einem Fehler (z. B. fehlende Pflichtfelder) zeigt der Browser die JSON-Antwort der API an, eine Weiterleitung findet nicht statt. Prüfen Sie Pflichtfelder deshalb mit required im Formular, oder verwenden Sie das JavaScript-SDK für eigene Fehlermeldungen.

:::