---
title: "Create user group"
method: POST
path: "/users/groups"
tags: ["Users"]
---

# Create user group

`POST /users/groups`

## Request

- Base URL: `https://localhost:8446/api/v2`
- URL: `https://localhost:8446/api/v2/users/groups`
- Auth: API key in header `Authorization`

Create new user group.

## Request body

- object
  - `name` string, required: Name
  - `description` number, required: Description
  - `permissions` object, required: Permissions
  - `permissions.groups` string, required: Agent groups permissions
  - `permissions.agents` string, required: Agents permissions
  - `permissions.create_new_job` boolean, required: Create new job permission
  - `permissions.jobs` object, required: Jobs permissions. Key is job id, value is "view only", "run", "write" or "full"

## Response `200`

Successful response

- object

## Other responses

- `default`: Error response. Depending on the error, either a 4xx or 5xx response status is returned.

---

[API](https://skmtc.dev/resilio/apis/resilio-api.md) - [All operations](https://skmtc.dev/resilio/apis/resilio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/resilio/apis/resilio-api/revisions/ca39130a395e?raw)