[comment]: # translation:outdated

[comment]: # ({a79da37c-a79da37c})
# user.create

[comment]: # ({/a79da37c-a79da37c})

[comment]: # ({6269f520-7dc5480b})
### Beschrijving

`object user.create(object/array users)`

Deze methode maakt het mogelijk om nieuwe gebruikers aan te maken.

::: noteclassic
Deze methode is alleen beschikbaar voor gebruikers met het type *Super admin*.
Toestemming om de methode aan te roepen kan worden ingetrokken in de instellingen van de gebruikersrol. Zie [Gebruikersrollen](/manual/web_interface/frontend_sections/users/user_roles)
voor meer informatie.
:::

::: noteclassic
De sterkte van het gebruikerswachtwoord wordt gevalideerd volgens de
wachtwoordbeleidsregels die zijn gedefinieerd door de Authenticatie-API. Zie [Authenticatie-API](/manual/api/reference/authentication) voor meer informatie.
:::

[comment]: # ({/6269f520-7dc5480b})

[comment]: # ({e25240b7-9e6b7fba})
### Parameters

`(object/array)` Gebruikers om aan te maken.

Naast de [standaard gebruikers-eigenschappen](object#user), accepteert de methode de volgende parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|usrgrps|array|Gebruikers-[groepen](/manual/api/reference/user/create) om de gebruiker aan toe te voegen.<br><br>De gebruikersgroepen moeten de eigenschap `usrgrpid` gedefinieerd hebben.|
|medias|array|Te creëren [media](/manual/api/reference/user/object#media) voor de gebruiker.|

[comment]: # ({/e25240b7-9e6b7fba})

[comment]: # ({7e32f5f9-7e32f5f9})
### Retourwaarden

`(object)` Retourneert een object dat de ID's van de aangemaakte gebruikers bevat
onder de eigenschap `userids`. De volgorde van de geretourneerde ID's komt overeen met de
volgorde van de doorgegeven gebruikers.

[comment]: # ({/7e32f5f9-7e32f5f9})

[comment]: # ({b41637d2-b41637d2})
### Voorbeelden

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({37809083-0df8c129})
#### Gebruiker aanmaken

Maak een nieuwe gebruiker aan, voeg hem toe aan een gebruikersgroep en maak een nieuw medium voor hem aan.

[Aanvraag](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "user.create",
    "params": {
        "username": "John",
        "passwd": "Doe123",
        "roleid": "5",
        "usrgrps": [
            {
                "usrgrpid": "7"
            }
        ],
        "medias": [
            {
                "mediatypeid": "1",
                "sendto": [
                    "support@company.com"
                ],
                "active": 0,
                "severity": 63,
                "period": "1-7,00:00-24:00"
            }
        ]
    },
    "id": 1
}
```

Reactie:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "userids": [
            "12"
        ]
    },
    "id": 1
}
```

[comment]: # ({/37809083-0df8c129})

[comment]: # ({130699eb-130699eb})
### Zie ook

- [Authenticatie](/manual/api/referentie/authenticatie)
- [Media](/manual/api/referentie/gebruiker/object#media)
- [Gebruikersgroep](/manual/api/reference/usergroup/object#user_group)
- [Rol](/manual/api/reference/role/object#role)

[comment]: # ({/130699eb-130699eb})

[comment]: # ({61de33e2-61de33e2})
### Bron

CUser::create() in *ui/include/classes/api/services/CUser.php*.

[comment]: # ({/61de33e2-61de33e2})