# user.create

### Описание

`объект user.create(объект/массив пользователи)`

Этот метод позволяет создавать новых пользователей.

### Параметры

`(объект/массив)` Создаваемые пользователи.

В дополнение к [стандартным свойствам
пользователя](object#пользователь), этот метод принимает следующие
параметры.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|**passwd**<br>*(требуется)*|строка|Пароль пользователя.|
|**usrgrps**<br>(требуется)|массив|Группы пользователей, в которые необходимо добавить пользователя.<br><br>У групп пользователей должно быть задано свойство `usrgrpid`.|
|user\_medias|массив|Создаваемые оповещения пользователей пользователю.<br><br>У оповещения пользователя не должно быть задано свойство `userid`.|

### Возвращаемые значения

`(объект)` Возвращает объект, который содержит ID созданных
пользователей под свойством `userids`. Порядок возвращаемых ID совпадает
с порядком переданных пользователей.

### Примеры

#### Создание пользователя

Создание нового пользователя, добавление его в группу пользователей и
создание ему оповещения пользователя.

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "user.create",
    "params": {
        "alias": "John",
        "passwd": "Doe123",
        "usrgrps": [
            {
                "usrgrpid": "7"
            }
        ],
        "user_medias": [
            {
                "mediatypeid": "1",
                "sendto": "support@company.com",
                "active": 0,
                "severity": 63,
                "period": "1-7,00:00-24:00"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

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

### Смотри также

-   [Оповещение
    пользователя](/ru/manual/api/reference/usermedia/object#оповещение_пользователя)
-   [Группа
    пользователей](/ru/manual/api/reference/usergroup/object#группа_пользователей)

### Исходный код

CUser::create() в
*frontends/php/include/classes/api/services/CUser.php*.