# Create a role

`POST https://backend.estactics.com/api/permissionsRoles/create`

Adds a new role with no permissions. Use Set role permissions to fill it in.

Authentication: `Authorization: Bearer YOUR_API_KEY`. Required permission: `permissionsRoles.MANAGE_ORG_ROLES`.

## Body parameters

- `name` (string, required): Role name.
- `description` (string): What the role is for.

## Example request body

```json
{
  "name": "Viewer",
  "description": "Read only access."
}
```

## Example response

```json
{
  "success": true,
  "data": {
    "id": 5
  }
}
```