Lead-API: Schnellstart

Mit der Lead-API senden Website-Formulare, Landing Pages und externe Quellen Leads direkt an Advision360. Jeder Lead landet auf dem Lead-Board der Firma, zu der der verwendete Lead-Schlüssel gehört.

Die API besteht aus einem einzigen Endpunkt:

POST https://app.advision360.de/api/public/leads

1. Lead-Schlüssel erstellen

Erstellen Sie in Advision360 unter Einstellungen → Lead- & Formular-Schlüssel einen Lead-Schlüssel. Er beginnt mit pk_live_. Details zum Umgang mit dem Schlüssel finden Sie unter Authentifizierung.

2. Integrationsweg wählen

Weg	Geeignet für
JavaScript-SDK	Bestehendes Formular auf Ihrer Website. Am einfachsten: Validierung und Versand übernimmt das SDK.
REST-API	Server-zu-Server-Anbindungen und eigene Frontends. Volle Kontrolle über Anfrage und Antwort.
HTML-Formular	Seiten ohne JavaScript. Das Formular sendet direkt an Advision360 und leitet danach weiter.

3. Ersten Lead senden

Ersetzen Sie YOUR_API_KEY durch Ihren Lead-Schlüssel. Mit "_test": true wird der Lead als Test-Lead markiert und lässt sich auf dem Lead-Board gesammelt löschen.

curl

curl -X POST https://app.advision360.de/api/public/leads \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "firstName": "Max",
    "lastName": "Mustermann",
    "email": "max@example.com",
    "_test": true
  }'

JavaScript-SDK

<form id="lead-form">
  <input name="firstName" required />
  <input name="lastName" required />
  <input name="email" type="email" />
  <button type="submit">Senden</button>
</form>

<script src="https://app.advision360.de/sdk/app.min.js"></script>
<script>
  Advision.configure({ apiKey: 'YOUR_API_KEY' })
  Advision.bindForm('#lead-form')
</script>

HTML-Formular

<form action="https://app.advision360.de/api/public/leads" method="POST">
  <input type="hidden" name="_key" value="YOUR_API_KEY" />
  <input name="firstName" required />
  <input name="lastName" required />
  <input name="email" type="email" />
  <button type="submit">Senden</button>
</form>

Bei Erfolg antwortet die API mit 201 Created. Der Lead erscheint sofort auf dem Lead-Board. Alle Felder, Antworten und Fehlercodes beschreibt die API-Referenz.