Endpoints / setLeadAssignee

setLeadAssignee

Lead einem User zuweisen (mit optionalem Mail-Notify)

userId=0 entfernt die Zuweisung. notify=true schickt dem Assignee eine Benachrichtigung per E-Mail.

HTTP Request

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

Auth basicAuth apiKey

Request Parameters

Parameter	Pflicht	Typ	Beispiel / Default
`leadId`	required	integer
`userId` 0 = Zuweisung entfernen	optional	integer
`notify`	optional	boolean	default: `false`

Response Parameters

Nebeneffekte: History-Eintrag vom Typ A, der neue Assignee wird automatisch zur Watchlist hinzugefügt und der zugehörige Cache invalidiert. Fehler: HTTP 400 Provide a valid leadId.

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/setLeadAssignee

Payload

{
    "leadId": 12345,
    "userId": 12,
    "notify": false
}

Response

{
    "status": true,
    "msg": "Success",
    "result": null
}