UNIO Immobilienbewertung

Webhook API Dokumentation

Diese Dokumentation beschreibt alle Felder, die beim Absenden einer Bewertungsanfrage per HTTP POST an den konfigurierten Webhook-Endpunkt gesendet werden.

Was hat sich geändert?

  • Neugarden_area — Gartenfläche in m², jetzt bei Wohnung, Haus & Zinshaus in Schritt 2 erfassbar.
  • Verschobenbalcony_area — jetzt in Schritt 2 (vorher Schritt 3), weiterhin bei Wohnung, Haus & Zinshaus.
  • Entfernt aus UIplot_area — Grundstücksfläche wird bei Wohnung, Haus & Zinshaus nicht mehr abgefragt und immer als null gesendet.

Endpoint

POSThttps://docs.boom-livings.com/valuation/webhook/webflow-form
Content-Typeapplication/json

Hinweis: Der Webhook-Endpunkt wird über die Umgebungsvariable WEBHOOK_URL konfiguriert. Bei Erfolg wird webhook_sent: true in der Datenbank gesetzt.

Feldübersicht

Meta

lead_id
string
Pflicht

Eindeutige ID des Leads in der Datenbank

z.B. "a1b2c3d4"

submitted_at
string (ISO 8601)
Pflicht

Zeitstempel der Einreichung

z.B. "2026-02-23T10:30:00.000Z"

is_vienna
boolean
Pflicht

true wenn PLZ zwischen 1010 und 1239 liegt (Wien)

z.B. true

Schritt 1 – Immobilientyp

property_type
string
Pflicht

Art der Immobilie

z.B. "Wohnung" | "Haus" | "Zinshaus" | "Grundstück"

Schritt 2 – Fläche

living_area
number
Pflicht

Wohnfläche (Wohnung/Haus), Nutzfläche (Zinshaus) oder Grundstücksfläche (Grundstück) in m²

z.B. 85

garden_area
number | null
OptionalNeu

Gartenfläche in m² — bei Wohnung, Haus & Zinshaus, optional

z.B. 150

balcony_area
number | null
OptionalVerschoben

Balkon- / Terrassenfläche in m² — bei Wohnung, Haus & Zinshaus, optional

z.B. 12

plot_area
number | null
OptionalEntfernt aus UI

Grundstücksfläche in m² — nicht mehr im UI erfassbar, wird immer null gesendet (Feld bleibt aus Kompatibilitätsgründen erhalten)

z.B. null

Schritt 3 – Zimmer & Details (Wohnung / Haus)

⚡ Nur befüllt wenn property_type = "Wohnung" oder "Haus"
rooms
number | null
Optional

Anzahl der Hauptzimmer (1–5+), nur Wohnung

z.B. 3

floors_count
number | null
Optional

Anzahl Stockwerke inkl. EG, nur Haus

z.B. 2

floor
number | null
Optional

Etage der Wohnung (optional, wenn kein floor_type)

z.B. 3

floor_type
string | null
Optional

Sonderetage

z.B. "DG" | "Maisonette"

has_parking
boolean
Optional

Eigene Garage oder Stellplatz vorhanden

z.B. true

Schritt 3 – Zinshaus Details

⚡ Nur befüllt wenn property_type = "Zinshaus"
nutzung
string | null
Pflicht

Nutzungsart des Gebäudes

z.B. "Wohnen" | "Gewerbe" | "Gemischt"

parifiziert
string | null
Pflicht

Grundbuchlicher Status der Einheiten

z.B. "Parifiziert" | "Unparifiziert" | "Weiß ich nicht"

rohdachboden
boolean | null
Optional

Rohdachboden vorhanden

z.B. true | false

area_vacant
number | null
Optional

Leerstandsfläche in m² (optional)

z.B. 80

area_fixed_term
number | null
Optional

Befristet vermietete Fläche in m² (optional)

z.B. 120

area_unlimited
number | null
Optional

Unbefristet vermietete Fläche in m² (optional)

z.B. 200

Schritt 3 – Grundstück (Bebaubarkeit)

⚡ Nur befüllt wenn property_type = "Grundstück"
buildable
string | null
Optional

Bebaubarkeit des Grundstücks

z.B. "Ja, Baugenehmigung vorhanden" | "Teilweise / in Planung" | "Nein / Grünland" | "Weiß ich nicht"

Schritt 4 – Zustand & Ausstattung

⚡ Nur befüllt wenn property_type ≠ "Grundstück"
condition
string | null
Pflicht

Aktueller Zustand der Immobilie

z.B. "Sehr gut gepflegt" | "Gepflegt" | "Renovierungsbedürftig"

furnishing
string | null
Optional

Ausstattungsqualität (nicht bei Zinshaus)

z.B. "Einfach" | "Standard" | "Gehoben" | "Luxus"

year_built
number | null
Pflicht

Baujahr der Immobilie

z.B. 1985

geb_saniert
boolean | null
OptionalNeu

Gebäude nachträglich saniert?

z.B. true

Schritt 4 – Grundstück Extras

⚡ Nur befüllt wenn property_type = "Grundstück"
extras
string[]
Optional

Besondere Grundstückseigenschaften (Mehrfachauswahl, kann leer sein)

z.B. ["Voll erschlossen", "Hanglage"]

Schritt 5 – Adresse

street
string | null
Pflicht

Straße & Hausnummer

z.B. "Mariahilfer Straße 100"

zip_code
string | null
Pflicht

Postleitzahl (4-stellig, Österreich)

z.B. "1060"

city
string | null
Pflicht

Ort / Stadt

z.B. "Wien"

address_display
string | null
Optional

Vollständige formatierte Adresse aus der Autocomplete-Suche

z.B. "Mariahilfer Straße 100, 1060 Wien"

Schritt 6 – Bewertungsgrund

valuation_reason
string | null
Pflicht

Grund für die Bewertungsanfrage

z.B. "Ich möchte verkaufen" | "Ich denke über einen Kauf nach" | "Ich möchte den Marktwert kennen"

Schritt 7 – Verkaufsgrund

⚡ Nur befüllt wenn valuation_reason = "Ich möchte verkaufen"
sale_reason
string | null
Optional

Grund für den geplanten Verkauf

z.B. "Scheidung / Trennung" | "Erbschaft" | "Umzug / Neustart" | "Finanzielle Gründe" | "Sonstiges"

Schritt 10 – Kontakt

first_name
string
Pflicht

Vorname des Interessenten

z.B. "Max"

last_name
string
Pflicht

Nachname des Interessenten

z.B. "Mustermann"

email
string
Pflicht

E-Mail-Adresse

z.B. "max@email.at"

phone
string
Pflicht

Telefonnummer (österreichisches Format erwartet)

z.B. "+43 123 456 789"

Formular-Flow nach Immobilientyp

Wohnung

  1. 1.1. Immobilientyp
  2. 2.2. Wohnfläche, Garten, Balkon/Terrasse (m²)
  3. 3.3. Zimmer, Etage, Stellplatz
  4. 4.4. Zustand, Ausstattung, Baujahr
  5. 5.5. Adresse
  6. 6.6. Bewertungsgrund
  7. 7.7. Verkaufsgrund *
  8. → Zusammenfassung → Analyse → Kontakt

* Nur wenn Bewertungsgrund = "Ich möchte verkaufen"

Haus

  1. 1.1. Immobilientyp
  2. 2.2. Wohnfläche, Garten, Balkon/Terrasse (m²)
  3. 3.3. Stockwerke, Stellplatz
  4. 4.4. Zustand, Ausstattung, Baujahr
  5. 5.5. Adresse
  6. 6.6. Bewertungsgrund
  7. 7.7. Verkaufsgrund *
  8. → Zusammenfassung → Analyse → Kontakt

* Nur wenn Bewertungsgrund = "Ich möchte verkaufen"

Zinshaus

  1. 1.1. Immobilientyp
  2. 2.2. Nutzfläche, Garten, Balkon/Terrasse (m²)
  3. 3.3. Nutzungsart, Parifizierung, Rohdachboden, Flächen nach Mietstatus
  4. 4.4. Zustand, Baujahr
  5. 5.5. Adresse
  6. 6.6. Bewertungsgrund
  7. 7.7. Verkaufsgrund *
  8. → Zusammenfassung → Analyse → Kontakt

* Nur wenn Bewertungsgrund = "Ich möchte verkaufen"

Grundstück

  1. 1.1. Immobilientyp
  2. 2.2. Grundstücksfläche (m²)
  3. 3.3. Bebaubarkeit
  4. 4.4. Besondere Merkmale (Extras)
  5. 5.5. Adresse
  6. 6.6. Bewertungsgrund
  7. 7.7. Verkaufsgrund *
  8. → Zusammenfassung → Analyse → Kontakt

* Nur wenn Bewertungsgrund = "Ich möchte verkaufen"

Beispiel-Payload (Wohnung, Wien)

{
  "lead_id": "a1b2c3d4",
  "submitted_at": "2026-02-23T10:30:00.000Z",
  "is_vienna": true,
  "property_type": "Wohnung",
  "living_area": 85,
  "garden_area": null,
  "balcony_area": 12,
  "plot_area": null,
  "rooms": 3,
  "floors_count": null,
  "floor": 3,
  "floor_type": null,
  "has_parking": false,
  "nutzung": null,
  "parifiziert": null,
  "rohdachboden": null,
  "area_vacant": null,
  "area_fixed_term": null,
  "area_unlimited": null,
  "buildable": null,
  "condition": "Gepflegt",
  "furnishing": "Standard",
  "year_built": 1995,
  "geb_saniert": true,
  "extras": [],
  "street": "Mariahilfer Straße 100",
  "zip_code": "1060",
  "city": "Wien",
  "address_display": "Mariahilfer Straße 100, 1060 Wien",
  "valuation_reason": "Ich möchte verkaufen",
  "sale_reason": "Umzug / Neustart",
  "first_name": "Max",
  "last_name": "Mustermann",
  "email": "max@email.at",
  "phone": "+43 123 456 789"
}

Hinweise für Entwickler

  • →Felder, die für den jeweiligen Immobilientyp nicht relevant sind, werden als null oder leeres Array [] übermittelt.
  • →Das Feld is_vienna wird serverseitig anhand der PLZ berechnet (1010–1239 = Wien).
  • →Das Feld sale_reason ist nur befüllt, wenn valuation_reason den Wert "Ich möchte verkaufen" hat.
  • →Der Webhook erwartet keine Authentifizierung. Für Sicherheit empfehlen wir eine IP-Whitelist oder ein Shared Secret als Query-Parameter.
  • →Bei einem HTTP 2xx Response gilt der Webhook als erfolgreich zugestellt und webhook_sent wird in der DB auf true gesetzt.
  • →Die Funktion liegt unter functions/submitLead.js. Der Endpunkt-URL kann im Dashboard unter Code → Functions eingesehen werden.

UNIO Immobilienbewertung · Stand: 4.9.2026