# Créer un utilisateur

> Créer directement la fiche d'un utilisateur par l'API publique, dans l'environnement de l'appelant et avec son profil, sans passer par une invitation.

Créez directement un utilisateur quand vous connaissez déjà son identité, par exemple lors d'une reprise de données ou d'une synchronisation avec votre annuaire. Keycloak lui envoie ensuite un e-mail pour vérifier son adresse et choisir son mot de passe. Dans les autres cas, préférez l'[invitation](/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.create`.
- Vous connaissez le WID du client et celui du profil à attribuer.
- Un administrateur client crée toujours l'utilisateur dans son propre client, quel que soit le client indiqué.
- Vous appelez avec un jeton ou une clé **de l'environnement visé** : la fiche est créée dans l'environnement de l'appelant, et seulement dans celui-là. Voir [Comptes et environnements](/v1.0/utilisateurs/comptes-et-environnements).

## Créer l'utilisateur

::endpoint{method="POST" path="/api/config/users"}

```bash
curl -X POST "https://api.wakastart.app/api/config/users" \
  -H "x-api-key: sk_test_exemple" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "paul.martin@cabinet-exemple.fr",
    "firstName": "Paul",
    "lastName": "Martin",
    "customerWid": "Cu9pL2",
    "profileWid": "Pr5sT1",
    "adminLevel": "USER"
  }'
```

```ts
const response = await fetch("https://api.wakastart.app/api/config/users", {
  method: "POST",
  headers: {
    "x-api-key": process.env.WAKASTART_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    email: "paul.martin@cabinet-exemple.fr",
    firstName: "Paul",
    lastName: "Martin",
    customerWid: "Cu9pL2",
    profileWid: "Pr5sT1",
    adminLevel: "USER",
  }),
});
const user = await response.json();
if (user.reconciledWithoutInvite) {
  console.warn("Compte Keycloak existant réutilisé : aucun e-mail envoyé.");
}
```

Réponse attendue (201, extrait) :

```json
{
  "id": "8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d1e",
  "wid": "Us2mK6",
  "email": "paul.martin@cabinet-exemple.fr",
  "firstName": "Paul",
  "lastName": "Martin",
  "adminLevel": "USER",
  "isActive": true,
  "envType": "prod"
}
```

Wakastart crée la fiche dans l'environnement de la clé (ici `prod`), crée le compte Keycloak dans le realm du réseau sur l'instance de cet environnement, l'ajoute au groupe et à l'organisation du client, ouvre l'accès à l'application et attribue le profil à la fiche. Keycloak envoie l'e-mail de vérification et de définition du mot de passe, valable 24 heures.

### Champs de la requête

| Champ | Obligatoire | Description |
|---|---|---|
| `email` | oui | 255 caractères au plus ; enregistrée en minuscules |
| `customerWid` | non | Client de l'utilisateur. `customerId` accepte l'UUID. Par défaut, le client de l'appelant. |
| `firstName`, `lastName` | non | 100 caractères chacun |
| `profileWid` | non | Profil attribué à la fiche, avec les droits de l'environnement de l'appelant. `profileId` accepte l'UUID. |
| `adminLevel` | non | `CUSTOMER_ADMIN`, `USER` ou `NONE` (par défaut). Jamais supérieur au niveau de l'appelant. |
| `temporaryPassword` | non | Mot de passe provisoire (8 caractères au moins), à changer à la première connexion |
| `requireEmailVerification` | non | `true` par défaut : l'utilisateur doit vérifier son adresse |
| `isActive` | non | `true` par défaut |

:::important
N'envoyez ni `envs`, ni `envType`, ni `env` : l'environnement est déduit de l'appelant, et ces champs sont refusés en `400` (`Environment is deduced from the caller and cannot be provided`). Pour créer la même personne dans un autre environnement, refaites l'appel avec un jeton ou une clé de cet environnement : il n'existe ni copie ni promotion de fiche.
:::

:::note
Si un compte Keycloak vérifié et actif existe déjà pour cette adresse dans le realm de cet environnement, Wakastart le réutilise et n'envoie **aucun** e-mail ; la réponse contient `"reconciledWithoutInvite": true`. Prévenez alors l'utilisateur qu'il peut se connecter avec son mot de passe habituel.
:::

## Vérifier le résultat

`GET /api/config/users/Us2mK6`, appelé avec une clé du même environnement, renvoie l'utilisateur, actif, rattaché au client, avec `"envType": "prod"`. L'utilisateur reçoit l'e-mail de Keycloak, choisit son mot de passe et se connecte à votre application.

## Dépannage

- Erreur 409 : un utilisateur avec cette adresse existe déjà dans ce client, dans cet environnement. Une fiche de la même adresse dans un autre environnement ne bloque pas la création.
- Erreur 400 `Environment is deduced from the caller and cannot be provided` : retirez `envs`, `envType` ou `env` du corps.
- Erreur 403 : le niveau demandé dépasse le vôtre, ou le droit `users.create` vous manque. Voir [Résoudre les problèmes d'utilisateurs](/v1.0/utilisateurs/depannage).

## Voir aussi

- [Comptes et environnements](/v1.0/utilisateurs/comptes-et-environnements)
- [Gérer un utilisateur](/v1.0/utilisateurs/gerer-un-utilisateur)
- [Référence API des utilisateurs](/v1.0/reference-api/utilisateurs)
