---
title: "Create a new user role in your service"
method: POST
path: "/v1/Services/{ChatServiceSid}/Roles"
tags: ["ConversationsV1Role"]
---

# Create a new user role in your service

`POST /v1/Services/{ChatServiceSid}/Roles`

## Request

- Base URL: `https://conversations.twilio.com`
- URL: `https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Roles`
- Auth: HTTP basic

Create a new user role in your service

## Path parameters

- `ChatServiceSid` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `FriendlyName` string, required: A descriptive string that you create to describe the new resource. It can be up to 64 characters long.
  - `Type` 'conversation' | 'service', required: The type of role. Can be: `conversation` for [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) roles or `service` for [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) roles.
  - `Permission` string[], required: 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`.

## Response `201`

Created

- ConversationsV1ServiceServiceRole
  - `sid` string, nullable: The unique string that we created to identify the Role resource.
  - `account_sid` string, nullable: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Role resource.
  - `chat_service_sid` string, nullable: The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the Role resource is associated with.
  - `friendly_name` string, nullable: The string that you assigned to describe the resource.
  - `type` 'conversation' | 'service': The type of role. Can be: `conversation` for [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) roles or `service` for [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) roles.
  - `permissions` string[], nullable: An array of the permissions the role has been granted.
  - `date_created` string, date-time, nullable: The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, nullable: The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `url` string, uri, nullable: An absolute API resource URL for this user role.

## Changes

- **2023-08-10** (v1) `4e3f150aaa78`: 1 info
  - api tag `ConversationsV1Role` added

[Operation history](https://skmtc.dev/twilio/apis/conversations-v1/changes/v1/Services/:ChatServiceSid/Roles/post.md)

---

[API](https://skmtc.dev/twilio/apis/conversations-v1.md) - [All operations](https://skmtc.dev/twilio/apis/conversations-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/conversations-v1/revisions/6a37056c7727?raw)