# Create a Compliance User Group

## POST /v2/admin/usergroups

> Create a user group.

```json
{"openapi":"3.1.1","info":{"title":"Restricted Pod API","version":"20.17.1"},"servers":[{"url":"https://yourpodURL.symphony.com/pod"}],"paths":{"/v2/admin/usergroups":{"post":{"summary":"Create a user group.","parameters":[{"schema":{"type":"string"},"name":"sessionToken","description":"Session authentication token.","in":"header","required":true}],"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserGroupResponse"}}}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized: Session tokens invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserGroupCreate"}}},"required":true}}}},"components":{"schemas":{"UserGroupResponse":{"description":"Group object response","type":"object","properties":{"id":{"description":"Group ID","type":"string"},"name":{"description":"Group name","type":"string"},"area":{"description":"An optional string attribute used for categorizing groups","type":"string"},"description":{"description":"Group description","type":"string"},"type":{"description":"Group type","type":"string"},"active":{"description":"Group status","type":"boolean"},"createdDate":{"description":"Date of group creation","type":"integer","format":"int64"},"modifiedDate":{"description":"Date of group last update","type":"integer","format":"int64"},"memberCount":{"description":"Number of group members","type":"integer","format":"int64"},"assigneeCount":{"description":"Number of group assignees","type":"integer","format":"int64"}}},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}},"UserGroupCreate":{"description":"Body for group creation","type":"object","properties":{"name":{"description":"Group name","type":"string"},"area":{"description":"Group area","type":"string"},"description":{"description":"Group description","type":"string"},"type":{"description":"Group type","type":"string"}},"required":["name","type"]}}}}
```

> #### 🚧 Roles and Privileges
>
> Calling this endpoint requires the **Scope Management** role with the MANAGE\_ROLE\_SCOPES entitleable action.\
> See [Bot Permissions](https://docs.developers.symphony.com/building-bots-on-symphony/configuration/bot-permissions) for a list of roles and associated privileges.