# Bulk action on contacts

Perform a bulk operation on contacts matching a filter. Supported actions include changing pipeline stage, assigning/removing tags, moving to a list, and deleting.

Endpoint: PUT /leads/api/leads/mass-action
Version: 2.0.0
Security: bearerAuth

## Request fields (application/json):

  - `type` (string, required)
    Action type: contact_change_pipeline_stage, contact_assign_tag, contact_remove_tag, contact_move_to_list, contact_delete, contact_mark_read.
    Example: "contact_change_pipeline_stage"

  - `payload` (object)
    Action-specific payload.
    Example: {"pipeline_stage_uuid":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"}

  - `filter` (object, required)
    Filter to select contacts.
    Example: {"ids":["uuid-1","uuid-2"]}

  - `filter.all` (boolean)

  - `filter.ids` (array)
    Example: ["uuid-1","uuid-2"]

## Response 200 fields (application/json):

  - `count` (integer)

  - `data` (array)

## Response 422 fields (application/json):

  - `message` (string)
    Example: "Validation failed for input parameters"

  - `errors` (object)