# Create role

**POST /v1/Services/{ServiceSid}/Roles**


Roles determining user or member permissions

## Servers
- https://chat.twilio.com: https://chat.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **ServiceSid** (string)
  The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) to create the resource under.


### Body: application/x-www-form-urlencoded (object)

- **FriendlyName** (string)
  A descriptive string that you create to describe the new resource. It can be up to 64 characters long.
- **Type** (string)
  The type of role. Can be: `channel` for [Channel](https://www.twilio.com/docs/chat/api/channels) roles or `deployment` for [Service](https://www.twilio.com/docs/chat/api/services) roles.
- **Permission** (array[string])
  A permission that you grant to the new role. Only one permission can be granted per parameter. To assign more than one permission, repeat this parameter for each permission value. The values for this parameter depend on the role's `type` and are described in the documentation.


## Responses
### 201
Created
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **sid** (string | null)
  The unique string that we created to identify the Role resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the Role resource.
- **service_sid** (string | null)
  The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) the resource is associated with.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource.
- **type** (string)
  The type of role. Can be: `channel` for [Channel](https://www.twilio.com/docs/chat/api/channels) roles or `deployment` for [Service](https://www.twilio.com/docs/chat/api/services) roles.
- **permissions** (array[string] | null)
  An array of the permissions the role has been granted, formatted as a JSON string.
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format.
- **url** (string(uri) | null)
  The absolute URL of the Role resource.


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