# Create a role

**POST /api/v2/roles**




## Servers
- https://api.plannrcrm.com: https://api.plannrcrm.com ()


## Authentication methods
- Personal access token & O auth2


## Parameters
### Headers
- **X-PLANNR-ACCOUNT-UUID** (string)




### Body: application/json (object)

- **name** (string)
  The name of the role.
- **description** (string)
  A description of the role.
- **permissions** (array[string])
  An array of permissions in the format "resource:verb".


## Responses
### 401


#### Body: application/json (object)
- **message** (string)



[Powered by Bump.sh](https://bump.sh)