Endpoints / bulkAssign

bulkAssign

Mehrere Leads einem User zuweisen (Bulk)

Setzt für mehrere Leads denselben Assignee. userId = 0 entfernt die Zuweisung.

HTTP Request

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

Auth basicAuth apiKey

Request Parameters

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

Response Parameters

⚠ Bei notify: true wird pro Lead eine Mail verschickt — bei grossen Mengen entsprechend vorsichtig einsetzen. Antwortformat identisch zu bulkSetFolder. Fehler: HTTP 400 Provide a non-empty leadIds array.

Field	Typ	Beschreibung
`updated`	integer	Anzahl geänderter Leads
`skipped`	array	Übersprungene Leads mit Begründung
`errors`	array	Fehlgeschlagene Leads mit Meldung

Demo

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

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

Payload

{
    "leadIds": [
        12345,
        12346,
        12347
    ],
    "userId": 12,
    "notify": false
}

Response

{
    "status": true,
    "msg": "Success",
    "result": {
        "updated": 3,
        "skipped": [],
        "errors": []
    }
}