Endpoints / bulkSetFolder

bulkSetFolder

Mehrere Leads in einen Folder verschieben (Bulk)

Verschiebt N Leads in denselben Folder. Result enthält pro Lead ein OK/Error-Flag. Folder 5/15 sind reserviert.

HTTP Request

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

Auth basicAuth apiKey

Request Parameters

Parameter	Pflicht	Typ	Beispiel / Default
`leadIds`	required	array
`folderId`	required	integer

Response Parameters

⚠ folderId 5 bzw. 15 (Disqualified) wird pro Lead in errors gelistet — dafür disqualifyLead je Lead verwenden. Pro Lead entstehen konsistent ein History-Eintrag und ein changeLog-Eintrag. Fehler: HTTP 400 bei leerem leadIds-Array oder ungültiger folderId.

Field	Typ	Beschreibung
`updated`	integer	Anzahl verschobener Leads
`skipped`	array	Übersprungene Leads, z. B. bereits im Zielordner
`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/bulkSetFolder

Payload

{
    "leadIds": [
        12345,
        12346,
        12347
    ],
    "folderId": 3
}

Response

{
    "status": true,
    "msg": "Success",
    "result": {
        "updated": 2,
        "skipped": [
            {
                "leadId": 12346,
                "reason": "already in folder"
            }
        ],
        "errors": [
            {
                "leadId": 12347,
                "msg": "not found"
            }
        ]
    }
}