Endpoints / disqualifyLead

disqualifyLead

Lead disqualifizieren (atomar Folder=5/15 + Reason)

Setzt Folder auf 5 (Patient) bzw. 15 (Kontakt) und speichert ReasonDisqualified in einer Operation.

HTTP Request

POST https://dev.vitabyte.ch/v1/sales/disqualifyLead
Auth basicAuth apiKey

Request Parameters

Gültige reasonCode-Werte kommen aus getReferenceData(kinds=["disqualification"]) — z. B. PRICE, NOFIT, OTHER.

Parameter Pflicht Typ Beispiel / Default
leadId required integer
reasonCode

Code aus getReferenceData(kinds=['disqualification'])

required string

Response Parameters

Fehler: HTTP 400 bei fehlender leadId oder fehlendem reasonCode, HTTP 422 Unknown reasonCode: <code>.

Field Typ Beschreibung
status boolean true bei Erfolg, false bei Fehler
msg string Kurzbeschreibung des Resultats / der Fehlerursache
result Endpoint-spezifisches Resultat. Typ je nach Endpoint (Object, Array, Skalar oder null).
pagination Nur bei Listen-Endpoints gesetzt

Demo

Beispiel-Response handgepflegt — die OpenAPI-Spec liefert für diesen Endpoint noch kein Response-Example.

POST https://dev.vitabyte.ch/v1/sales/disqualifyLead
Payload
{
    "leadId": 12345,
    "reasonCode": "PRICE"
}
Response
{
    "status": true,
    "msg": "Success",
    "result": null
}