# Importer des utilisateurs

> Créer jusqu'à 500 utilisateurs d'un client à partir d'un fichier CSV avec l'API publique, et savoir ce que l'import ne fait pas.

L'import CSV crée en une fois les comptes d'un client : utile pour reprendre une liste existante au démarrage d'un projet. Chaque ligne valide devient une fiche utilisateur dans l'environnement de l'appelant, avec un compte Keycloak dans le realm du réseau, sur l'instance de cet environnement.

:::important[Ce que l'import ne fait pas]
- **Il n'attribue aucun profil** : les utilisateurs importés n'ont aucun droit dans votre application tant que vous ne leur attribuez pas un profil.
- **Il crée les fiches dans un seul environnement** : celui de la clé API utilisée, ou celui de la session de l'administrateur. Rien n'est copié dans les autres environnements, même pour une adresse qui y a déjà une fiche. Sans environnement déductible, l'import est refusé (`400`), jamais rabattu sur la production.
- **Il n'envoie pas d'invitation** : seul l'e-mail Keycloak de vérification de l'adresse et de définition du mot de passe part.
- **Il ne rattache à aucune équipe.**

Pour faire entrer des utilisateurs avec le bon profil dès le départ, utilisez les [invitations](/v1.0/utilisateurs/inviter-un-utilisateur).
:::

## Avant de commencer

- Vous appelez l'API avec une [clé API](/v1.0/cles-api) ou le jeton d'un administrateur, de niveau Administrateur client au moins, avec le droit `users.import`. Le téléchargement du modèle demande `users.read`.
- Vous connaissez l'UUID du client (`id`, renvoyé par `GET /api/config/customers/{wid}`). Un administrateur client ne peut importer que dans son propre client.
- Vous utilisez une clé ou une session **de l'environnement visé** : pour importer en staging, une clé de staging.
- L'import consomme des crédits du client (opération `IMPORT_USERS`), débités au lancement. Vérifiez le solde : voir [Crédits](/v1.0/credits).

## Préparer le fichier

::::steps
### Télécharger le modèle

::endpoint{method="GET" path="/api/import/users/template"}

```bash
curl -o import-users-template.csv "https://api.wakastart.app/api/import/users/template" \
  -H "x-api-key: sk_test_exemple"
```

Résultat : un fichier `import-users-template.csv` avec l'en-tête et une ligne d'exemple.

### Remplir une ligne par utilisateur

```csv
email,firstName,lastName,adminLevel
marie.dupont@cabinet-exemple.fr,Marie,Dupont,USER
paul.martin@cabinet-exemple.fr,Paul,Martin,CUSTOMER_ADMIN
```

- `email` est obligatoire ;
- `firstName` et `lastName` sont facultatifs ;
- `adminLevel` vaut `NONE` s'il est vide, sinon `CUSTOMER_ADMIN`, `USER` ou `NONE` ; il ne peut pas dépasser votre propre niveau. Les niveaux d'administration au-delà du client (`NETWORK_ADMIN`, `APP_ADMIN`, `PARTNER_ADMIN`) sont refusés ligne par ligne : l'import ne crée que des utilisateurs du client.

Le séparateur est la virgule. Enregistrez le fichier en UTF-8 : 2 Mo et 500 lignes de données au plus.
::::

## Lancer l'import

::endpoint{method="POST" path="/api/import/users?customerId={customerId}"}

```bash
curl -X POST "https://api.wakastart.app/api/import/users?customerId=5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f8a" \
  -H "x-api-key: sk_test_exemple" \
  -F "file=@utilisateurs.csv;type=text/csv"
```

```ts
import { readFile } from "node:fs/promises";

const csv = await readFile("utilisateurs.csv");
const form = new FormData();
form.append("file", new Blob([csv], { type: "text/csv" }), "utilisateurs.csv");

const response = await fetch(
  "https://api.wakastart.app/api/import/users?customerId=5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f8a",
  { method: "POST", headers: { "x-api-key": process.env.WAKASTART_API_KEY! }, body: form },
);
const report = await response.json();
```

Réponse attendue (201) :

```json
{
  "total": 2,
  "successCount": 1,
  "errorCount": 1,
  "created": [
    { "line": 2, "email": "marie.dupont@cabinet-exemple.fr", "wid": "Us8hJ4" }
  ],
  "errors": [
    { "line": 3, "email": "paul.martin@cabinet-exemple.fr", "error": "adminLevel CUSTOMER_ADMIN depasse votre niveau d'administration" }
  ]
}
```

Le numéro de ligne compte l'en-tête comme ligne 1. Une ligne en erreur n'empêche pas l'import des autres. Une adresse qui a déjà une fiche chez ce client **dans cet environnement** est en erreur ; une fiche dans un autre environnement ne gêne pas.

## Compléter les comptes importés

1. Attribuez un profil à chaque utilisateur importé, dans le même environnement : voir [Attribuer un profil](/v1.0/droits-et-profils/attribuer-un-profil).
2. Si besoin, ajoutez-les à leurs équipes : voir [Gérer les équipes](/v1.0/utilisateurs/gerer-les-equipes).

## Vérifier le résultat

`GET /api/config/users?customerWid=Cu9pL2`, appelé avec une clé du même environnement, liste les utilisateurs créés, avec les WID du rapport. Chacun reçoit l'e-mail Keycloak pour choisir son mot de passe.

## Voir aussi

- [Résoudre les problèmes d'utilisateurs](/v1.0/utilisateurs/depannage#le-fichier-csv-est-refusé)
- [Référence API des utilisateurs](/v1.0/reference-api/utilisateurs)
