# create_group

Create a workspace group, optionally granting its members a role.

Members added to a role-bearing group inherit that role's permissions. Requires  
workspace billing-admin permission.

## Parameters

| Parameter             | Type            | Default | Description                                                                                                                                                     |
| --------------------- | --------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| workspace\_idrequired | string (uuid)   | —       | The workspace to create the group in.                                                                                                                           |
| namerequired          | string1–∞ chars | —       | The group's name. Must be unique within the workspace.                                                                                                          |
| role                  | enum            | —       | Optional workspace role to grant every member (admin, editor, artist, ...). Omit for none.One of: admin, editor, settings\_admin, art\_director, artist, member |