> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstwork.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Operations

> Perform high-volume actions on applications, contracts, and data with reliable background processing

## Overview

**Bulk Operations** enable you to perform actions on hundreds or thousands of records at once. Bulk operations are reliable, traceable, and won't time out — even for very large datasets.

## Available Bulk Operations

### Applications

| Operation                    | Description                                              |
| ---------------------------- | -------------------------------------------------------- |
| **Bulk Create**              | Import multiple applications from CSV or external source |
| **Bulk Status Update**       | Change status for multiple applications                  |
| **Bulk Stage Transition**    | Move applications to a specific stage                    |
| **Bulk Trigger Automations** | Fire automations for selected applications               |
| **Bulk Delete**              | Remove applications (with audit trail)                   |
| **Bulk Recollection**        | Request data re-collection from candidates               |

### Contracts

| Operation                    | Description                                            |
| ---------------------------- | ------------------------------------------------------ |
| **Bulk Create**              | Create multiple contracts from hiring flow completions |
| **Bulk Status Update**       | Change status for multiple contracts                   |
| **Bulk Trigger Automations** | Fire automations for selected contracts                |

### Data

| Operation       | Description                            |
| --------------- | -------------------------------------- |
| **Bulk Import** | Import data from CSV files             |
| **Bulk Export** | Export filtered data to CSV            |
| **Data Sync**   | Synchronize data with external systems |

## How Bulk Operations Work

```mermaid theme={null}
graph TD
    A[Select Records] --> B[Configure Operation]
    B --> C[Processing Starts]
    C --> D[Records Processed in Batches]
    D --> E{More Records?}
    E -->|Yes| D
    E -->|No| F[Operation Complete]
    D --> G[Progress Updates]
    G --> H[Dashboard / Notifications]
```

### Reliable Processing

Bulk operations run reliably in the background with:

1. **Reliability** — Operations continue even during system maintenance
2. **Progress Tracking** — Real-time progress updates in the dashboard
3. **Error Handling** — Individual record failures don't stop the entire operation
4. **Retry Logic** — Automatic retries for transient failures
5. **Cancellation** — Operations can be cancelled mid-execution
6. **Audit Trail** — Complete record of what was processed

## Bulk Application Import

Import applications from external sources:

### Prepare your data

Format your data as CSV with columns matching your hiring flow's form fields.

### Map fields

Map CSV columns to Firstwork form elements and application fields.

### Configure options

* Duplicate detection strategy
* Default stage assignment
* Auto-advance rules
* Error handling policy

### Execute import

The system processes records in batches, creating users, applications, and form submissions.

### Review results

View the import report showing successful imports, skipped duplicates, and errors.

## Bulk Status Updates

Update multiple applications or contracts at once by selecting them in the dashboard and choosing the target stage or status. Bulk updates can also be triggered programmatically via the [API](/api-reference/endpoints/update-application-status).

### Safety Features

* **Confirmation** — Review affected records before executing
* **Dry run** — Preview what would change without executing
* **Rollback** — Undo bulk operations (where supported)
* **Audit log** — Complete record of bulk actions

## Data Sync

**Data Sync** operations synchronize data between Firstwork and external systems:

| Feature             | Description                             |
| ------------------- | --------------------------------------- |
| Connectors          | Pre-built connectors for common systems |
| Scheduling          | Automated sync on a schedule            |
| Conflict Resolution | Configurable merge strategies           |
| History             | History of sync executions with results |
| Field Mapping       | Map external fields to Firstwork fields |

## Monitoring Bulk Operations

Track bulk operation progress directly in the Firstwork dashboard:

* Operations in progress with real-time status
* Success/failure rates per operation
* Average processing time
* Records processed per day
* Detailed error logs for failed records