Lead API: quick start

The Lead API lets website forms, landing pages and external sources send leads straight into Advision360. Every lead lands on the lead board of the company that owns the lead key used.

The API consists of a single endpoint:

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

1. Create a lead key

In Advision360, create a lead key under Settings → Lead & form keys. It starts with pk_live_. How to handle the key is described under Authentication.

2. Choose an integration

Integration	Best for
JavaScript SDK	An existing form on your website. The easiest option: the SDK handles validation and submission.
REST API	Server-to-server integrations and custom frontends. Full control over request and response.
HTML form	Pages without JavaScript. The form posts directly to Advision360 and redirects afterwards.

3. Send your first lead

Replace YOUR_API_KEY with your lead key. "_test": true marks the lead as a test lead, so you can delete all test leads at once on the lead board.

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">Send</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 form

<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">Send</button>
</form>

On success the API responds with 201 Created and the lead shows up on the lead board right away. All fields, responses and error codes are described in the API reference.