[comment]: # ({0c2aa75d-cb1e13cf})
# proxygroup.create

[comment]: # ({/0c2aa75d-cb1e13cf})

[comment]: # ({6640b733-38bb2f4e})
### Description

`object proxygroup.create(object/array proxyGroups)`

This method allows to create new proxy groups.

::: noteclassic
This method is only available to *Super admin* user type. Permissions to call the method can be revoked in user role
settings. See [User roles](/manual/web_interface/frontend_sections/users/user_roles) for more information.
:::

[comment]: # ({/6640b733-38bb2f4e})

[comment]: # ({613c6911-3692832e})
### Parameters

`(object/array)` Proxy groups to create.

The method accepts proxy groups with the [standard proxy group properties](object#proxy-group).

[comment]: # ({/613c6911-3692832e})

[comment]: # ({30cd480a-c9b95d36})
### Return values

`(object)` Returns an object containing the IDs of the created proxy groups under the `proxy_groupids` property.
The order of the returned IDs matches the order of the passed proxy groups.

[comment]: # ({/30cd480a-c9b95d36})

[comment]: # ({b41637d2-38fb38c0})
### Examples

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

[comment]: # ({a22537d5-99ceee0d})
#### Create a proxy group

Create a proxy group with custom settings.

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

```json
{
    "jsonrpc": "2.0",
    "method": "proxygroup.create",
    "params": {
        "name": "Proxy group",
        "failover_delay": "5m",
        "min_online": "10"
    },
    "id": 1
}
```

Response:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "proxy_groupids": [
            "5"
        ]
    },
    "id": 1
}
```

[comment]: # ({/a22537d5-99ceee0d})

[comment]: # ({9ab61d82-c4815acc})
### Source

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

[comment]: # ({/9ab61d82-c4815acc})