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

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

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

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

Aquest mètode permet crear nous usuaris.

::: noteclassic
Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/users/user_roles).
:::

::: noteclassic
La fortalesa del mot de pas de l'usuari es valida d'acord amb les regles de la política de mots de pas definida per l'API d'autenticació. Veieu [API d'autenticació](/manual/api/reference/authentication) per obtindre més informació.
:::

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

[comment]: # ({db383808-9e6b7fba})
### Paràmetres

`(object/array)` usuaris a crear.

A més de les [propietats d'usuari estàndard](object#user), el mètode admet els paràmetres següents.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data-types)|Descripció|
|--|--|------|
|usrgrps|array|[Grups d'usuaris](/manual/api/reference/usergroup/object#user-group) on afegir l'usuari.<br><br>Els grups d'usuaris han de tindre només la propietat `usrgrpid ` definida.|
|medias|array|[Suport d'usuari](/manual/api/reference/user/object#media) a crear.|

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

[comment]: # ({7e32f5f9-7e32f5f9})
### Valors de retorn

`(object)` Retorna un objecte amb els IDs dels usuaris creats segons la propietat `userids`. L'ordre dels IDs retornats correspon a l'ordre dels usuaris donats.

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

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

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

[comment]: # ({37809083-0df8c129})
#### Crear un usuari

Crea un usuari nou, l'afegeix a un grup d'usuaris i crea un nou suport per a ell.

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

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

Resposta:

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

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

[comment]: # ({b839f25d-130699eb})
### Veieu també

-   [Autenticació](/manual/api/reference/authentication)
-   [Suport](/manual/api/reference/user/object#media)
-   [Grup d'usuaris](/manual/api/reference/usergroup/object#user-group)
-   [Rol](/manual/api/reference/role/object#role)

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

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

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

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