[comment]: # ({5ebe3ff8-5ebe3ff8})
# hostgroup.create

[comment]: # ({/5ebe3ff8-5ebe3ff8})

[comment]: # ({0a562b4e-06c5b0b6})
### Beschrijving

`object hostgroup.create(object/array hostGroups)`

Met deze methode kunnen nieuwe hostgroepen worden aangemaakt.

::: noteclassic
Deze methode is alleen beschikbaar voor gebruikers van het type *Superadmin*.
Rechten om de methode te bellen kunnen worden ingetrokken in de instellingen van de gebruikersrol. Zie [Gebruikersrollen](/manual/web_interface/frontend_sections/users/user_roles) voor meer informatie.
:::

[comment]: # ({/0a562b4e-06c5b0b6})

[comment]: # ({9743504d-7c6d41ff})
### Parameters

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

De methode accepteert hostgroepen
met de [standaardeigenschappen van hostgroepen](object#host_group).

[comment]: # ({/9743504d-7c6d41ff})

[comment]: # ({e3c164f1-e3c164f1})
### Retourwaarden

`(object)` Retourneert een object dat de ID's van de gemaakte host
groepen onder de eigenschap `groupids`. De volgorde van de geretourneerde ID's
komt overeen met de volgorde van de doorgegeven hostgroepen.

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

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

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

[comment]: # ({f82f8eea-37cc26c2})
#### Hostgroep aanmaken

Maak een hostgroep genaamd "Linux servers" aan.

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

```json
{
    "jsonrpc": "2.0",
    "method": "hostgroup.create",
    "params": {
        "name": "Linux servers"
    },
    "id": 1
}
```

Antwoord:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "107819"
        ]
    },
    "id": 1
}
```

[comment]: # ({/f82f8eea-37cc26c2})

[comment]: # ({df4dc6d7-df4dc6d7})
### Bron

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

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