Endpoints / processIntake

processIntake

Atomarer Marketing-Webhook (Lead + Admission + Consent)

Erstellt Lead, Admission und Consent in einem Call. Bei Teilfehler Rollback (Lead soft-deleted). Empfohlen für externe Marketing-Tools statt mehrerer Einzel-Calls.

HTTP Request

POST https://dev.vitabyte.ch/v1/sales/processIntake

Auth basicAuth apiKey

Request Parameters

Idempotenz ist Pflicht: ein zweiter Aufruf mit identischem idempotencyKey liefert die Original-IDs ohne neuen Insert. Schlägt ein Teilschritt fehl (z. B. die Aufnahme), wird der Lead per Rollback soft-deleted.

Parameter	Pflicht	Typ	Beispiel / Default
`lead` Payload im intakeLead-Format; mindestens lastname, email, phone oder mobile.	required	object
`idempotencyKey` Eindeutiger Schlüssel des Formulars bzw. Webhooks.	required	string	form-uuid-here
`preferredAdmission` from, until und comment — wird als Aufnahme angelegt.	optional	object
`consent` newsletter und dataProcessing als Boolean.	optional	object

Response Parameters

Fehler: HTTP 400 Provide lead payload. / Provide idempotencyKey., HTTP 500 wenn Lead-Insert und Rollback fehlschlagen.

Field	Typ	Beschreibung
`leadId`	integer	ID des Leads
`uniqid`	string	Stabile externe ID des Leads
`admissionId`	integer	ID der angelegten Aufnahme, falls preferredAdmission mitgegeben wurde

Demo

Parameter und Beispiele stammen aus der internen API-Collection; die OpenAPI-Spec weicht für diesen Endpoint davon ab.

POST https://dev.vitabyte.ch/v1/sales/processIntake

Payload

{
    "idempotencyKey": "form-uuid-here",
    "lead": {
        "salutation": "Herr",
        "firstname": "Max",
        "lastname": "Mustermann",
        "dob": "21.02.1980",
        "email": "max@example.com",
        "phone": "+41 79 000 00 00",
        "street": "Musterstrasse",
        "streetex": "1",
        "zip": "8000",
        "city": "Zürich",
        "country": "CH",
        "kvg": "Helsana",
        "hx_Hauptleiden": "Knie"
    },
    "preferredAdmission": {
        "from": "2026-06-01",
        "until": "2026-06-15",
        "comment": "Möchte Einzelzimmer"
    },
    "consent": {
        "newsletter": true,
        "dataProcessing": true
    }
}

Response

{
    "status": true,
    "msg": "Success",
    "result": {
        "leadId": 12347,
        "uniqid": "7c93e15ba4d20",
        "admissionId": 88
    }
}