Skip to main content

Bulk Update

POST 
/api/leads/bulk-update

Simple bulk update endpoint for leads.

Updates multiple leads with the same data. Handles both regular field updates and position updates with group context.

Examples:

  1. Update single lead position (drag & drop):
{
    "lead_ids": ["id1"],
    "updates": {
        "position": 5
    },
    "group_context": {
        "group_by": "priority",
        "group_value": "high"
    }
}
  1. Update multiple leads with same data:
{
    "lead_ids": ["id1", "id2", "id3"],
    "updates": {
        "priority": "high",
        "assignee": "user123"
    }
}
  1. Update by filter conditions:
{
    "filters": {
        "priority": "low",
        "lifecycle_stage": "lead"
    },
    "updates": {
        "priority": "medium"
    }
}
  1. Update multiple positions (after reordering):
{
    "lead_ids": ["id1", "id2", "id3"],
    "updates": {
        "positions_map": {
            "id1": 0,
            "id2": 1,
            "id3": 2
        }
    },
    "group_context": {
        "group_by": "priority",
        "group_value": "high"
    }
}

Request​

Responses​

Successful Response