> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/en/administration/import-collaborateurs.md).

# How do I bulk import employees?

### Overview

The import feature allows you to add or synchronize collaborators in bulk from a file, without having to add them one by one.

### How it works

#### Step 1 — Processing history

From collaborator administration, go to the page **Import** which lists the history of previous synchronizations.

#### Step 2 — Choose the import type

Select the operation type: **add**, **delete** or **mirror synchronization**.

#### Step 3 — Upload the file

Upload the Excel or CSV file containing the collaborators.

#### Step 4 — Review alerts

The system analyzes the file and displays an**alerts** report on the anomalies detected (invalid rows, missing fields, etc.).

#### Step 5 — Review the analysis

An**analysis** report details the operations that will be executed (creations, updates, deletions).

#### Step 6 — Start execution

Confirm to launch the **runner** which applies the operations. The status is updated live.

#### Types of operations

* **Add** (upsert): create new collaborators or update existing ones
* **Delete** (delete): remove collaborators
* **Mirror synchronization** (mirror): replace the entire list — collaborators absent from the file are removed

#### Test mode (dry run)

It is possible to run a simulation before actually applying the changes. Test mode displays a report of the planned operations without applying them.

#### Message tracking

Each synchronization operation generates tracking messages indicating the result for each collaborator (success, error, etc.).

### Alternative: SCIM provisioning

For automatic and continuous synchronization with a company directory (Azure Active Directory, Okta, etc.), see the article "Automatic collaborator provisioning (Provisioning / SCIM)".

### What the assistant can do

The assistant cannot launch a bulk import. It can explain how it works and guide you to the administration interface. With the Administration scope, the assistant can add collaborators one by one.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.steeple.com/en/administration/import-collaborateurs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.